Home » openjdk-7 » java » rmi » activation » [javadoc | source]
java.rmi.activation
public interface: ActivationSystem [javadoc | source]

All Implemented Interfaces:
    Remote

The ActivationSystem provides a means for registering groups and "activatable" objects to be activated within those groups. The ActivationSystem works closely with the Activator, which activates objects registered via the ActivationSystem, and the ActivationMonitor, which obtains information about active and inactive objects, and inactive groups.
Field Summary
public static final  int SYSTEM_PORT    The port to lookup the activation system. 
Method from java.rmi.activation.ActivationSystem Summary:
activeGroup,   getActivationDesc,   getActivationGroupDesc,   registerGroup,   registerObject,   setActivationDesc,   setActivationGroupDesc,   shutdown,   unregisterGroup,   unregisterObject
Method from java.rmi.activation.ActivationSystem Detail:
 public ActivationMonitor activeGroup(ActivationGroupID id,
    ActivationInstantiator group,
    long incarnation) throws UnknownGroupException, ActivationException, RemoteException
    Callback to inform activation system that group is now active. This call is made internally by the ActivationGroup.createGroup method to inform the ActivationSystem that the group is now active.
 public ActivationDesc getActivationDesc(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
    Returns the activation descriptor, for the object with the activation identifier, id.
 public ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
    Returns the activation group descriptor, for the group with the activation group identifier, id.
 public ActivationGroupID registerGroup(ActivationGroupDesc desc) throws ActivationException, RemoteException
    Register the activation group. An activation group must be registered with the ActivationSystem before objects can be registered within that group.
 public ActivationID registerObject(ActivationDesc desc) throws ActivationException, UnknownGroupException, RemoteException
    The registerObject method is used to register an activation descriptor, desc, and obtain an activation identifier for a activatable remote object. The ActivationSystem creates an ActivationID (a activation identifier) for the object specified by the descriptor, desc, and records, in stable storage, the activation descriptor and its associated identifier for later use. When the Activator receives an activate request for a specific identifier, it looks up the activation descriptor (registered previously) for the specified identifier and uses that information to activate the object.

 public ActivationDesc setActivationDesc(ActivationID id,
    ActivationDesc desc) throws ActivationException, UnknownObjectException, UnknownGroupException, RemoteException
    Set the activation descriptor, desc for the object with the activation identifier, id. The change will take effect upon subsequent activation of the object.
 public ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id,
    ActivationGroupDesc desc) throws ActivationException, UnknownGroupException, RemoteException
    Set the activation group descriptor, desc for the object with the activation group identifier, id. The change will take effect upon subsequent activation of the group.
 public  void shutdown() throws RemoteException
    Shutdown the activation system. Destroys all groups spawned by the activation daemon and exits the activation daemon.
 public  void unregisterGroup(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
    Remove the activation group. An activation group makes this call back to inform the activator that the group should be removed (destroyed). If this call completes successfully, objects can no longer be registered or activated within the group. All information of the group and its associated objects is removed from the system.
 public  void unregisterObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
    Remove the activation id and associated descriptor previously registered with the ActivationSystem; the object can no longer be activated via the object's activation id.