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 group
RemoteException
- 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, 2011, Oracle and/or its affiliates. All rights reserved.