Package jain.protocol.ip

This package contains the JAIN IP Factory, which is the central creation point for all high level proprietary JAIN IP objects, for example JainSipStack Objects.

See:
Description

Class Summary

JainIPFactory

The JAIN(tm) IP Factory is a singleton class by which JAIN IP applications can obtain a proprietary (Peer) JAIN IP Object.

Exception Summary

IPException	This JAIN IP Exception is thrown when a general JAIN IP Error is encountered, and may be used when no other specific Jain IP Exception is relevant.
IPListenerAlreadyRegisteredException	This exception is thrown if the add Jain Listener method of a Jain Provider is invoked to add a Jain Listener to the list of registered Event Listeners, and the Jain Listener to be added is already a current registered Event Listener.
IPListenerNotRegisteredException	This exception is thrown if the remove Jain Listener method of a Jain Provider is invoked to remove a Jain Listener from he list of registered Event Listeners, and the Jain Listener to be removed is not currently a registered Event Listener.
IPPeerUnavailableException	The IP Peer Unavailable Exception indicates that the JAIN IP Peer (a particular implementation of JAIN IP) is unavailable on the current system.

Package jain.protocol.ip Description

This package contains the JAIN IP Factory, which is the central creation point for all high level proprietary JAIN IP objects, for example JainSipStack Objects. The Factory provides an interface for creating families of related or dependent objects without specifiying their concrete classes.

The Jain IP Factory may be used by applications to create proprietary IP objects. From this object it is then possible to instantiate JAIN IP Provider objects relevent to that IP protocol stack. For example any application may go to the JainIPFactory to get an Instance of a JainSipStackImpl Object, that JainSipStackImpl Object can then be used to create JainSipProviderImpl Objects, which provide a method of communication for any JainSipListenerImpl Object with the underlying stack of that JainSipStackImpl Object. This architecture for JAIN IP Object creation was adopted to:

• Provide a central point for Object creation, and force the use of JAIN IP Objects from the one family.
• Ensure the code deals only with an interface to an object, therefore can work with any concrete classes that support that interface.
• Provide more flexible and reusable code, by eliminating the instantiation of application specific classes.
• Ensure it can be adapted easily to Remote Method Invocation, which is essential for a distributed environment.