The Jini Specifications

This book contains the formal specification for the core Jini technology, as well as specifications for local helper utilities and remote helper services. It offers a review of distributed computing fundamentals, an overview of the Jini architecture, and an introduction to the key concepts that are the source of the technology's simplicity and power--remote objects, leasing, distributed events, and a two-phase commit protocol. The formal specifications provide the definitive description of every element of the Jini architecture, including detailed information on such topics as:

• Jini discovery and join protocols
• Jini entry usage
• Jini distributed leasing concepts
• Jini distributed event programming model
• Jini transaction model and semantics
• Jini lookup service and lookup attribute schema
• Jini discovery, event, leasing, and join utilities
• Jini lookup discovery, lease renewal, and event mailbox helper services
• Jini device architecture

Contents

• Goals
• Architecture
• What the Jini Architecture Depends Upon
• The Value of a Proxy
• The Lookup Service
• Attributes
• Membership Management
• Lookup Groups
• Lookup Service Compared to Naming/Directory Services
• Conclusion
• Notes on the Example Code
• Package Structure
• The MessageStream Interface
• The Client
• In Conclusion
• Good Lookup Citizenship
• The JoinManager Utility
• The FortuneStream Service
• The Implementation Design
• Creating the Service
• The Running Service
• The ChatStream Service
• "Service" versus "Server"
• Creating the Service
• The Chat Server
• Implementing nextInLine
• Notes on Improving ChatServerImpl
• The Clients
• Introduction
• Goals of the System
• Environmental Assumptions
• System Overview
• Key Concepts
• Services
• Lookup Service
• Java Remote Method Invocation (RMI)
• Security
• Leasing
• Transactions
• Events
• Component Overview
• Infrastructure
• Programming Model
• Services
• Service Architecture
• Discovery and Lookup Protocols
• Service Implementation
• An Example
• Registering the Printer Service
• Discovering the Lookup Service
• Joining the Lookup Service
• Optional Configuration
• Staying Alive
• Printing
• Locate the Lookup Service
• Search for Printing Services
• Configuring the Printer
• Requesting That the Image Be Printed
• Registering for Notification
• Receiving Notification
• Introduction
• Terminology
• Host Requirements
• Protocol Stack Requirements for IP Networks
• Protocol Overview
• Discovery in Brief
• Groups
• The Multicast Request Protocol
• The Multicast Announcement Protocol
• The Unicast Discovery Protocol
• The Discovery Protocols
• Protocol Roles
• The Multicast Request Protocol
• Protocol @PARTHEAD =icipants
• The Multicast Request Service
• Request Packet Format
• The Multicast Response Service
• Discovery Using the Multicast Request Protocol
• Steps Taken by the Discovering Entity
• Steps Taken by the Multicast Request Server
• Handling Responses from Multiple Djinns
• The Multicast Announcement Protocol
• The Multicast Announcement Service
• The Protocol
• Unicast Discovery
• The Protocol
• Request Format
• Response Format
• The Join Protocol
• Persistent State
• The Join Protocol
• Initial Discovery and Registration
• Lease Renewal and Handling of Communication Problems
• Making Changes and Performing Updates
• Joining or Leaving a Group
• Network Issues
• Properties of the Underlying Transport
• Limitations on Packet Sizes
• Bridging Calls to the Discovery Request Service
• Limiting the Scope of Multicasts
• Using Multicast IP as the Underlying Transport
• Address and Port Mappings for TCP and Multicast UDP
• LookupLocator Class
• Jini Technology URL Syntax
• Serialized Form
• Entries and Templates
• Operations
• Entry
• Serializing Entry Objects
• UnusableEntryException
• Templates and Matching
• Introduction
• Leasing and Distributed Systems
• Goals and Requirements
• Basic Leasing Interfaces
• Characteristics of a Lease
• Basic Operations
• Leasing and Time
• Serialized Forms
• Example Supporting Classes
• A Renewal Class
• A Renewal Service
• Introduction
• Distributed Events and Notifications
• Goals and Requirements
• The Basic Interfaces
• Entities Involved
• Overview of the Interfaces and Classes
• Details of the Interfaces and Classes
• The RemoteEventListener Interface
• The RemoteEvent Class
• The UnknownEventException
• An Example EventGenerator Interface
• The EventRegistration Class
• Sequence Numbers, Leasing and Transactions
• Serialized Forms
• Third-@PARTHEAD =y Objects
• Store-and-Forward Agents
• Notification Filters
• Notification Multiplexing
• Notification Demultiplexing
• Notification Mailboxes
• Compositionality
• Integration with JavaBeans Components
• Differences with the JavaBeans Component Event Model
• Converting Distributed Events to JavaBeans Component Events
• Introduction
• Model and Terms
• Distributed Transactions and ACID Properties
• Requirements
• The Two-Phase Commit Protocol
• Starting a Transaction
• Starting a Nested Transaction
• Joining a Transaction
• Transaction States
• Completing a Transaction: The Client's View
• Completing a Transaction: A @PARTHEAD =icipant's View
• Completing a Transaction: The Manager's View
• Crash Recovery
• The Roll Decision
• Durability
• Default Transaction Semantics
• Transaction and NestableTransaction Interfaces
• TransactionFactory Class
• ServerTransaction and NestableServerTransaction Classes
• CannotNestException Class
• Semantics
• Serialized Forms
• Introduction
• The Lookup Service Model
• Attributes
• The ServiceRegistrar
• ServiceID
• ServiceItem
• ServiceTemplate and Item Matching
• Other Supporting Types
• ServiceRegistrar
• ServiceRegistration
• Serialized Forms
• Summary
• Terminology
• Terms Related to Discovery and Join
• Jini Clients and Services
• Helper Service
• Helper Utility
• Managed Sets
• What Exceptions Imply about Future Behavior
• Unavailable Lookup Services
• Discarding a Lookup Service
• Active Communication Discarded Event
• Active No-Interest Discarded Event
• Passive Communication Discarded Event
• Passive No-Interest Discarded Event
• Changed Event
• Remote Objects, Stubs, and Proxies
• Activation
• Introduction to the Helper Utilities
• The Discovery Utilities
• The DiscoveryManagement Interface
• The DiscoveryGroupManagement Interface
• The DiscoveryLocatorManagement Interface
• The LookupDiscovery Helper Utility
• The LookupLocatorDiscovery Helper Utility
• The LookupDiscoveryManager Helper Utility
• The Constants Class
• The OutgoingMulticastRequest Utility
• The IncomingMulticastRequest Utility
• The OutgoingMulticastAnnouncement Utility
• The IncomingMulticastAnnouncement Utility
• The OutgoingUnicastRequest Utility
• The IncomingUnicastRequest Utility
• The OutgoingUnicastResponse Utility
• The IncomingUnicastResponse Utility
• The Lease Utilities
• The LeaseRenewalManager Helper Utility
• The Join Utilities
• The JoinManager Helper Utility
• The Service Discovery Utilities
• The ServiceDiscoveryManager Helper Utility
• Introduction to the Helper Services
• The Lookup Discovery Service
• The Lease Renewal Service
• The Event Mailbox Service
• Dependencies
• Introduction
• Dependencies
• The Discovery Management Interfaces
• Overview
• Other Types
• The DiscoveryManagement Interface
• The Semantics
• The DiscoveryGroupManagement Interface
• The Semantics
• The DiscoveryLocatorManagement Interface
• The Semantics
• Supporting Interfaces and Classes
• The DiscoveryListener Interface
• The DiscoveryChangeListener Interface
• The DiscoveryE