|
|||||||||
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 failsActivationGroupID registerGroup(ActivationGroupDesc groupDesc) throws ActivationException, RemoteException
groupDesc
- the activation group descriptor.
ActivationException
- if the group registration fails
RemoteException
- 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 registered
ActivationException
- if this group is already active
RemoteException
- if the remote call failsvoid 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 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 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 failsActivationGroupDesc 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 failsActivationDesc 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 failsActivationGroupDesc 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 |