Seven
0.1
Developer Guide

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Abstract

Developer guide explaining the JSC programming model by a walk-through of some examples that should run in any compliant Jini™ Service Container, as well as providing insight in some Seven features that will ease the development of JSC Services.


Table of Contents

About This Guide
1. Introduction
2. Getting started with the Seven Suite
1. Starting Seven
2. Starting the Jini Service Browser and Seven Administration Console
3. Installing the example services
4. Running the example services
3. Building the example services
1. Layout of development environment
2. The HelloService JSC Service
2.1. The HelloService business interface
2.2. The HelloService remote interface
2.3. The HelloService implementation
2.4. Creating the JSC deployment descriptor
2.5. Packaging the Service Archive
3. The HelloClient JSC Service
3.1. The HelloClient implementation
3.2. Creating the JSC deployment descriptor
4. The HelloGoodbyeService JSC Service with smart proxy
4.1. The HelloGoodbyeService business interfaces
4.2. The HelloGoodbyeService remote interface
4.3. The HelloGoodbyeService implementation
4.4. Creation of download JAR file for smart proxy
4. Whois Service
5. Troubleshooting JSC Services
1. Remote debugging
2. Seven logging facilities
2.1. Dynamic logger reconfiguration
2.2. Logger namespace
2.2.1. JSC Service logger name space
2.2.2. Absolute logger name space Seven
2.2.3. Absolute logger name space JSC Platform and service providers
2.3. XML logger configuration
2.3.1. 'Absolute' logger configuration
2.3.2. 'Service' logger configuration
6. Leasing
1. JSC programming model support for Leases
2. JSC example service with leasing support
3. Troubleshooting lease related problems
7. Events
8. Security
1. Keystore for private keys and trusted certificates

List of Figures

2.1. Jini Service Browser after startup
2.2. Jini Service Browser when lookup service has been selected
2.3. Jini Service Browser about to pop-up ServiceUI for Seven
2.4. Seven Administration Console
2.5. Administration Console installing SAR file
2.6. Administration Console after installing SAR files
2.7. Administration Console creating service instance
2.8. Administration Console after creating service instance
2.9. Administration Console after creating all service instance
2.10. Administration Console starting Hello service
2.11. Administration Console after starting Hello client
2.12. Jini Service Browser after starting example services
5.1. Logger configuration

List of Tables

5.1. J2SE 1.4 Loggers for JSC Service used by Seven
5.2. J2SE 1.4 Loggers for Seven
5.3. J2SE 1.4 Loggers for XML Configuration plug-in
5.4. J2SE 1.4 Loggers for Persistence plug-in
5.5. J2SE 1.4 Loggers for JSC Platform in net.jini namespace
5.6. J2SE 1.4 Loggers for preferred classes
5.7. J2SE 1.4 Loggers for Discovery Protocol v1 and v2
5.8. J2SE 1.4 Loggers for Join and Service Discovery management
5.9. J2SE 1.4 Loggers for asynchronous operations