java.rmi.activation.ActivationSystem |
The 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.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | SYSTEM_PORT | The port to lookup the activation system. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Callback to inform activation system that group is now
active.
| |||||||||||
Returns the activation descriptor, for the object with the activation
identifier,
id . | |||||||||||
Returns the activation group descriptor, for the group
with the activation group identifier,
id . | |||||||||||
Register the activation group.
| |||||||||||
The
registerObject method is used to register an
activation descriptor, desc , and obtain an
activation identifier for a activatable remote object. | |||||||||||
Set the activation descriptor,
desc for the object with
the activation identifier, id . | |||||||||||
Set the activation group descriptor,
desc for the object
with the activation group identifier, id . | |||||||||||
Shutdown the activation system.
| |||||||||||
Remove the activation group.
| |||||||||||
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. |
The port to lookup the activation system.
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.
id | the activation group's identifier |
---|---|
group | the group's instantiator |
incarnation | the group's incarnation number |
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 |
Returns the activation descriptor, for the object with the activation
identifier, id
.
id | the activation identifier for the activatable object |
---|
UnknownObjectException | if id is not registered |
---|---|
ActivationException | for general failure |
RemoteException | if remote call fails |
Returns the activation group descriptor, for the group
with the activation group identifier, id
.
id | the activation group identifier for the group |
---|
UnknownGroupException | if id is not registered |
---|---|
ActivationException | for general failure |
RemoteException | if remote call fails |
Register the activation group. An activation group must be
registered with the ActivationSystem
before objects
can be registered within that group.
desc | the group's descriptor |
---|
ActivationException | if group registration fails |
---|---|
RemoteException | if remote call fails |
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.
desc | the object's activation descriptor |
---|
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 |
Set the activation descriptor, 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 object |
---|---|
desc | the activation descriptor for the activatable object |
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 |
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.
id | the activation group identifier for the activation group |
---|---|
desc | the activation group descriptor for the activation group |
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 |
Shutdown the activation system. Destroys all groups spawned by the activation daemon and exits the activation daemon.
RemoteException | if failed to contact/shutdown the activation daemon |
---|
Remove the activation group. An activation group makes this call back to inform the activator that the group should be removed (destroyed). If this call completes successfully, objects can no longer be registered or activated within the group. All information of the group and its associated objects is removed from the system.
id | the activation group's identifier |
---|
ActivationException | if unregister fails (e.g., database update failure, etc). |
---|---|
UnknownGroupException | if group is not registered |
RemoteException | if remote call fails |
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.
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 fails |