public interface ActivationSystem extends Remote
The ActivationSystem registers groups and activatable objects to be activated within those groups. The ActivationSystem cooperates with both the Activator, which activates objects registered via the ActivationSystem, and the ActivationMonitor, which obtains information about active and inactive objects and inactive groups.
The activation system if frequently a remote object. As a security mean, all
methods in this interface throw AccessException
if called
from the client that is not reside on the same host as the activation system.
ActivationGroup.getSystem()
Modifier and Type | Field and Description |
---|---|
static int |
SYSTEM_PORT
The port, used by the activation system.
|
Modifier and Type | Method and Description |
---|---|
ActivationMonitor |
activeGroup(ActivationGroupID id,
ActivationInstantiator group,
long incarnation)
This method is called from the
ActivationGroup to inform the
ActivatinSystem that the group is now active and there is the
ActivationInstantiator for that group. |
ActivationDesc |
getActivationDesc(ActivationID id)
Get the activation descriptor for the object with the given activation id.
|
ActivationGroupDesc |
getActivationGroupDesc(ActivationGroupID groupId)
Get the group descriptor for the group with the given id.
|
ActivationGroupID |
registerGroup(ActivationGroupDesc groupDesc)
Register the new activation group.
|
ActivationID |
registerObject(ActivationDesc desc)
Registers the activation descriptor and creates (and returns) its
activation identifier.
|
ActivationDesc |
setActivationDesc(ActivationID id,
ActivationDesc desc)
Replace the activation descriptor for the object with the given activation
id.
|
ActivationGroupDesc |
setActivationGroupDesc(ActivationGroupID groupId,
ActivationGroupDesc groupDesc)
Replaces the group descriptor for the group with the given group activation
id.
|
void |
shutdown()
Shutdown the activation system and all associated activation groups
|
void |
unregisterGroup(ActivationGroupID id)
Removes the activation group with the given identifier.
|
void |
unregisterObject(ActivationID id)
Removes the stored identifier-description map entry.
|
static final int SYSTEM_PORT
ActivationID registerObject(ActivationDesc desc) throws ActivationException, UnknownGroupException, RemoteException
Activator
receives the request
to activate the object.desc
- the activation descriptor to register.ActivationException
- if the registration fails (database update
problems, etc).UnknownGroupException
- the if group, specified in decriptor, is
unknown.RemoteException
- if the remote call fails.void unregisterObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
id
- the activation id to removeActivationException
- if the entry removing operation failed
(database update problems, etc)UnknownObjectException
- if the passed id is not known to the systemRemoteException
- if the remote call failsActivationGroupID registerGroup(ActivationGroupDesc groupDesc) throws ActivationException, RemoteException
groupDesc
- the activation group descriptor.ActivationException
- if the group registration failsRemoteException
- if the remote call failsActivationMonitor activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation) throws UnknownGroupException, ActivationException, RemoteException
ActivationGroup
to inform the
ActivatinSystem that the group is now active and there is the
ActivationInstantiator
for that group. This call is made internally
from the ActivationGroup.createGroup(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc, long)
.id
- the group idgroup
- the group activation instantiatorincarnation
- the groups incarnatin number.UnknownGroupException
- if this group has not been registeredActivationException
- if this group is already activeRemoteException
- if the remote call failsvoid unregisterGroup(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
id
- the group activation id.ActivationException
- if the database update failsUnknownGroupException
- if such group is not registeredRemoteException
- if the remote call failsvoid shutdown() throws RemoteException
RemoteException
- if the remote call failsActivationDesc setActivationDesc(ActivationID id, ActivationDesc desc) throws ActivationException, UnknownObjectException, UnknownGroupException, RemoteException
id
- the activation iddesc
- the new activation descriptorActivationException
- if the database update failsUnknownObjectException
- if the object with such id is not knownUnknownGroupException
- if the activation group (in desc) is not
known.RemoteException
- if the remote call failsActivationGroupDesc setActivationGroupDesc(ActivationGroupID groupId, ActivationGroupDesc groupDesc) throws ActivationException, UnknownGroupException, RemoteException
groupId
- the group idgroupDesc
- the new group descriptorActivationException
- if the database update failsUnknownGroupException
- if such group is not knownRemoteException
- if the remote call failsActivationDesc getActivationDesc(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
id
- the object activation idActivationException
- if the database access failsUnknownObjectException
- if this object is not knownRemoteException
- if the remote call failsActivationGroupDesc getActivationGroupDesc(ActivationGroupID groupId) throws ActivationException, UnknownGroupException, RemoteException
groupId
- the group idActivationException
- if the database access failsUnknownGroupException
- if the group with such id is not knownRemoteException
- if the remote call fails