ActivationSystem JDK 1.6)

public ActivationMonitor activeGroup (ActivationGroupID id, ActivationInstantiator group, long incarnation) throws UnknownGroupException ActivationException RemoteException

Callback to inform activation system that group is now active.

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.
Returns: monitor for activation group
Parameters:
- id - the activation group's identifier
- group - the group's instantiator
- incarnation - the group's incarnation number
Throws:
- UnknownGroupException - if group is not registered
- ActivationException - if a group for the specified id is already active and that group is not equal to the specified group or that group has a different incarnation than the specified group
- RemoteException - if remote call fails
Since: 1.2

public ActivationDesc getActivationDesc (ActivationID id) throws ActivationException UnknownObjectException RemoteException

Returns the activation descriptor, for the object with the activation identifier, id.

Returns the activation descriptor, for the object with the activation
identifier, id.
Returns: the activation descriptor
Parameters:
- id - the activation identifier for the activatable object
Throws:
- UnknownObjectException - if id is not registered
- ActivationException - for general failure
- RemoteException - if remote call fails
Since: 1.2
See Also: ActivationSystem.setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc),

public ActivationGroupDesc getActivationGroupDesc (ActivationGroupID id) throws ActivationException UnknownGroupException RemoteException

Returns the activation group descriptor, for the group with the activation group identifier, id.

Returns the activation group descriptor, for the group
with the activation group identifier, id.
Returns: the activation group descriptor
Parameters:
- id - the activation group identifier for the group
Throws:
- UnknownGroupException - if id is not registered
- ActivationException - for general failure
- RemoteException - if remote call fails
Since: 1.2
See Also: ActivationSystem.setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc),

public ActivationGroupID registerGroup (ActivationGroupDesc desc) throws ActivationException RemoteException

Register the activation group.

Register the activation group. An activation group must be
registered with the ActivationSystem before objects
can be registered within that group.
Returns: an identifier for the group
Parameters:
- desc - the group's descriptor
Throws:
- ActivationException - if group registration fails
- RemoteException - if remote call fails
Since: 1.2

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 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.

Returns: the activation id that can be used to activate the object
Parameters:
- desc - the object's activation descriptor
Throws:
- ActivationException - if registration fails (e.g., database update failure, etc).
- UnknownGroupException - if group referred to in desc is not registered with this system
- RemoteException - if remote call fails
Since: 1.2

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.

Set the activation descriptor, desc for the object with
the activation identifier, id. The change will take
effect upon subsequent activation of the object.
Returns: the previous value of the activation descriptor
Parameters:
- id - the activation identifier for the activatable object
- desc - the activation descriptor for the activatable object
Throws:
- UnknownGroupException - the group associated with desc is not a registered group
- UnknownObjectException - the activation id is not registered
- ActivationException - for general failure (e.g., unable to update log)
- RemoteException - if remote call fails
Since: 1.2
See Also: ActivationSystem.getActivationDesc(java.rmi.activation.ActivationID),

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.

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.
Returns: the previous value of the activation group descriptor
Parameters:
- id - the activation group identifier for the activation group
- desc - the activation group descriptor for the activation group
Throws:
- UnknownGroupException - the group associated with id is not a registered group
- ActivationException - for general failure (e.g., unable to update log)
- RemoteException - if remote call fails
Since: 1.2
See Also: ActivationSystem.getActivationGroupDesc(java.rmi.activation.ActivationGroupID),

public void shutdown () throws RemoteException

Shutdown the activation system.

public void unregisterGroup (ActivationGroupID id) throws ActivationException UnknownGroupException RemoteException

Remove the activation group.

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.

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.
Parameters:
- id - the object's activation id (from previous registration)
Throws:
- ActivationException - if unregister fails (e.g., database update failure, etc).
- UnknownObjectException - if object is unknown (not registered)
- RemoteException - if remote call fails
Since: 1.2