Interface java.rmi.activation.ActivationSystem
- public interface ActivationSystem
- extends Remote
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.
- Since:
- JDK1.2
- See Also:
- Activator, ActivationMonitor
Field Summary
|
static int
|
SYSTEM_PORT
The port to lookup the activation system
|
SYSTEM_PORT
public static final int SYSTEM_PORT
- The port to lookup the activation system
registerObject
public ActivationID registerObject(ActivationDesc desc) throws ActivationException, UnknownGroupException, RemoteException
- 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.
- Parameters:
desc
- the object's activation descriptor
- Returns:
- the activation id that can be used to activate the object
- Throws:
- 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
unregisterObject
public void unregisterObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
- 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.
- Parameters:
id
- the object's activation id (from previous registration)
- Throws:
- ActivationException - if unregister fails (e.g., database
update failure, etc).
- UnknownObjectException - if object is unknown (not registered)
- RemoteException - if remote call fails
registerGroup
public ActivationGroupID registerGroup(ActivationGroupDesc desc) throws ActivationException, RemoteException
- Register the activation group. An activation group must be
registered with the
ActivationSystem
before objects
can be registered within that group.
- Parameters:
desc
- the group's descriptor
- Returns:
- an identifier for the group
- Throws:
- ActivationException - if group registration fails
- RemoteException - if remote call fails
activeGroup
public ActivationMonitor activeGroup(ActivationGroupID id,
ActivationInstantiator group,
long incarnation) throws UnknownGroupException, ActivationException, RemoteException
- 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.
- Parameters:
id
- the activation group's identifier
group
- the group's instantiator
incarnation
- the group's incarnation number
- Throws:
- UnknownGroupException - if group is not registered
- ActivationException - if group is already active
- RemoteException - if remote call fails
unregisterGroup
public void unregisterGroup(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
- 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.
- Parameters:
id
- the activation group's identifier
- Throws:
- ActivationException - if unregister fails (e.g., database
update failure, etc).
- UnknownGroupException - if group is not registered
- RemoteException - if remote call fails
shutdown
public void shutdown() throws RemoteException
- Shutdown the activation system. Destroys all groups spawned by
the activation daemon and exits the activation daemon.
Submit a bug or feature
Submit comments/suggestions about new javadoc look.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.