|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface ActivationSystem
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()| Field Summary | |
|---|---|
static int |
SYSTEM_PORT
The port, used by the activation system. |
| Method Summary | |
|---|---|
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. |
| Field Detail |
|---|
static final int SYSTEM_PORT
| Method Detail |
|---|
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 remove
ActivationException - if the entry removing operation failed
(database update problems, etc)
UnknownObjectException - if the passed id is not known to the system
RemoteException - if the remote call fails
ActivationGroupID registerGroup(ActivationGroupDesc groupDesc)
throws ActivationException,
RemoteException
groupDesc - the activation group descriptor.
ActivationException - if the group registration fails
RemoteException - if the remote call fails
ActivationMonitor 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 registered
ActivationException - if this group is already active
RemoteException - if the remote call fails
void unregisterGroup(ActivationGroupID id)
throws ActivationException,
UnknownGroupException,
RemoteException
id - the group activation id.
ActivationException - if the database update fails
UnknownGroupException - if such group is not registered
RemoteException - if the remote call fails
void shutdown()
throws RemoteException
RemoteException - if the remote call fails
ActivationDesc setActivationDesc(ActivationID id,
ActivationDesc desc)
throws ActivationException,
UnknownObjectException,
UnknownGroupException,
RemoteException
id - the activation iddesc - the new activation descriptor
ActivationException - if the database update fails
UnknownObjectException - if the object with such id is not known
UnknownGroupException - if the activation group (in desc) is not
known.
RemoteException - if the remote call fails
ActivationGroupDesc setActivationGroupDesc(ActivationGroupID groupId,
ActivationGroupDesc groupDesc)
throws ActivationException,
UnknownGroupException,
RemoteException
groupId - the group idgroupDesc - the new group descriptor
ActivationException - if the database update fails
UnknownGroupException - if such group is not known
RemoteException - if the remote call fails
ActivationDesc getActivationDesc(ActivationID id)
throws ActivationException,
UnknownObjectException,
RemoteException
id - the object activation id
ActivationException - if the database access fails
UnknownObjectException - if this object is not known
RemoteException - if the remote call fails
ActivationGroupDesc getActivationGroupDesc(ActivationGroupID groupId)
throws ActivationException,
UnknownGroupException,
RemoteException
groupId - the group id
ActivationException - if the database access fails
UnknownGroupException - if the group with such id is not known
RemoteException - if the remote call fails
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||