public interface ActivationSystem extends Remote
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.Activator,
ActivationMonitor| Modifier and Type | Field and Description |
|---|---|
static int |
SYSTEM_PORT
The port to lookup the activation system.
|
| Modifier and Type | Method and Description |
|---|---|
ActivationMonitor |
activeGroup(ActivationGroupID id,
ActivationInstantiator group,
long incarnation)
Callback to inform activation system that group is now
active.
|
ActivationDesc |
getActivationDesc(ActivationID id)
Returns the activation descriptor, for the object with the activation
identifier,
id. |
ActivationGroupDesc |
getActivationGroupDesc(ActivationGroupID id)
Returns the activation group descriptor, for the group
with the activation group identifier,
id. |
ActivationGroupID |
registerGroup(ActivationGroupDesc desc)
Register the activation group.
|
ActivationID |
registerObject(ActivationDesc desc)
The
registerObject method is used to register an
activation descriptor, desc, and obtain an
activation identifier for a activatable remote object. |
ActivationDesc |
setActivationDesc(ActivationID id,
ActivationDesc desc)
Set the activation descriptor,
desc for the object with
the activation identifier, id. |
ActivationGroupDesc |
setActivationGroupDesc(ActivationGroupID id,
ActivationGroupDesc desc)
Set the activation group descriptor,
desc for the object
with the activation group identifier, id. |
void |
shutdown()
Shutdown the activation system.
|
void |
unregisterGroup(ActivationGroupID id)
Remove the activation group.
|
void |
unregisterObject(ActivationID 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. |
static final int SYSTEM_PORT
ActivationID registerObject(ActivationDesc desc) throws ActivationException, UnknownGroupException, RemoteException
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. desc - the object's activation descriptorActivationException - if registration fails (e.g., database
update failure, etc).UnknownGroupException - if group referred to in
desc is not registered with this systemRemoteException - if remote call failsvoid unregisterObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
ActivationSystem; the object
can no longer be activated via the object's activation id.id - the object's activation id (from previous registration)ActivationException - if unregister fails (e.g., database
update failure, etc).UnknownObjectException - if object is unknown (not registered)RemoteException - if remote call failsActivationGroupID registerGroup(ActivationGroupDesc desc) throws ActivationException, RemoteException
ActivationSystem before objects
can be registered within that group.desc - the group's descriptorActivationException - if group registration failsRemoteException - if remote call failsActivationMonitor activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation) throws UnknownGroupException, ActivationException, RemoteException
ActivationGroup.createGroup method to inform
the ActivationSystem that the group is now
active.id - the activation group's identifiergroup - the group's instantiatorincarnation - the group's incarnation numberUnknownGroupException - if group is not registeredActivationException - 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 groupRemoteException - if remote call failsvoid unregisterGroup(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
id - the activation group's identifierActivationException - if unregister fails (e.g., database
update failure, etc).UnknownGroupException - if group is not registeredRemoteException - if remote call failsvoid shutdown()
throws RemoteException
RemoteException - if failed to contact/shutdown the activation
daemonActivationDesc setActivationDesc(ActivationID id, ActivationDesc desc) throws ActivationException, UnknownObjectException, UnknownGroupException, RemoteException
desc for the object with
the activation identifier, id. The change will take
effect upon subsequent activation of the object.id - the activation identifier for the activatable objectdesc - the activation descriptor for the activatable objectUnknownGroupException - the group associated with
desc is not a registered groupUnknownObjectException - the activation id
is not registeredActivationException - for general failure (e.g., unable
to update log)RemoteException - if remote call failsgetActivationDesc(java.rmi.activation.ActivationID)ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc) throws ActivationException, UnknownGroupException, RemoteException
desc for the object
with the activation group identifier, id. The change will
take effect upon subsequent activation of the group.id - the activation group identifier for the activation groupdesc - the activation group descriptor for the activation groupUnknownGroupException - the group associated with
id is not a registered groupActivationException - for general failure (e.g., unable
to update log)RemoteException - if remote call failsgetActivationGroupDesc(java.rmi.activation.ActivationGroupID)ActivationDesc getActivationDesc(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
id.id - the activation identifier for the activatable objectUnknownObjectException - if id is not registeredActivationException - for general failureRemoteException - if remote call failssetActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
id.id - the activation group identifier for the groupUnknownGroupException - if id is not registeredActivationException - for general failureRemoteException - if remote call failssetActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc) Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2015, Oracle and/or its affiliates. All rights reserved.