java.rmi.activation

Interface Activator

All Superinterfaces:

java.rmi.Remote

public interface Activator
extends java.rmi.Remote

Activates remote object, providing the live reference to the activable remote object. Usually there is only one activator per host.

See Also:

ActivationSystem, ActivationMonitor

Method Summary

Methods

Modifier and Type	Method and Description
java.rmi.MarshalledObject<? extends java.rmi.Remote>	activate(ActivationID id, boolean force) Activate the object, associated with the given activation identifier.

Method Detail

activate

java.rmi.MarshalledObject<? extends java.rmi.Remote> activate(ActivationID id,
                                                            boolean force)
                                                              throws ActivationException,
                                                                     UnknownObjectException,
                                                                     java.rmi.RemoteException

Activate the object, associated with the given activation identifier. The activator looks for the ActivationDescriptor for the passed identifier, determines the object activation group and initiates object recreation either via ActivationInstantiator or via Class.newInstance().

Parameters:

id - the identifier of the object to activate.

force - if true, the activator always contacts the group to obtain the reference. If false, it may return the cached value.

Returns:

the activated remote object (its stub).

Throws:

UnknownObjectException - if the object with this id is unknown

ActivationException - if the activation has failed due other reason

java.rmi.RemoteException - if the remote call has failed.