Module java.rmi
Package java.rmi.activation
Provides support for RMI Object Activation. A remote
object's reference can be made ``persistent'' and later activated into a
``live'' object using the RMI activation mechanism.
Implementations are not required to support the activation
mechanism. If activation is not supported by this implementation,
several specific activation API methods are all required to throw
UnsupportedOperationException. If activation is supported by this
implementation, these methods must never throw
UnsupportedOperationException. These methods are denoted by the
presence of an entry for UnsupportedOperationException in the
Throws section of each method's specification.
- Since:
- 1.2
-
Interface Summary Interface Description ActivationInstantiator AnActivationInstantiatoris responsible for creating instances of "activatable" objects.ActivationMonitor AnActivationMonitoris specific to anActivationGroupand is obtained when a group is reported active via a call toActivationSystem.activeGroup(this is done internally).ActivationSystem TheActivationSystemprovides a means for registering groups and "activatable" objects to be activated within those groups.Activator TheActivatorfacilitates remote object activation. -
Class Summary Class Description Activatable TheActivatableclass provides support for remote objects that require persistent access over time and that can be activated by the system.ActivationDesc An activation descriptor contains the information necessary to activate an object: the object's group identifier, the object's fully-qualified class name, the object's code location (the location of the class), a codebase URL path, the object's restart "mode", and, a "marshalled" object that can contain object specific initialization data.ActivationGroup AnActivationGroupis responsible for creating new instances of "activatable" objects in its group, informing itsActivationMonitorwhen either: its object's become active or inactive, or the group as a whole becomes inactive.ActivationGroup_Stub ActivationGroup_Stubis a stub class for the subclasses ofjava.rmi.activation.ActivationGroupthat are exported as ajava.rmi.server.UnicastRemoteObject.ActivationGroupDesc An activation group descriptor contains the information necessary to create/recreate an activation group in which to activate objects.ActivationGroupDesc.CommandEnvironment Startup options for ActivationGroup implementations.ActivationGroupID The identifier for a registered activation group serves several purposes: identifies the group uniquely within the activation system, and contains a reference to the group's activation system so that the group can contact its activation system when necessary.ActivationID Activation makes use of special identifiers to denote remote objects that can be activated over time. -
Exception Summary Exception Description ActivateFailedException This exception is thrown by the RMI runtime when activation fails during a remote call to an activatable object.ActivationException General exception used by the activation interfaces.UnknownGroupException AnUnknownGroupExceptionis thrown by methods of classes and interfaces in thejava.rmi.activationpackage when theActivationGroupIDparameter to the method is determined to be invalid, i.e., not known by theActivationSystem.UnknownObjectException AnUnknownObjectExceptionis thrown by methods of classes and interfaces in thejava.rmi.activationpackage when theActivationIDparameter to the method is determined to be invalid.