- All Implemented Interfaces:
public class ActivationID extends Object implements Serializable
Activation makes use of special identifiers to denote remote objects that can be activated over time. An activation identifier (an instance of the class
ActivationID) contains several pieces of information needed for activating an object:
- a remote reference to the object's activator (a
- a unique identifier (a
UIDinstance) for the object.
An activation identifier for an object can be obtained by registering an object with the activation system. Registration is accomplished in a few ways:
- via the
- via the first
Activatableconstructor (that takes three arguments and both registers and exports the object, and
- via the first
Activatable.exportObjectmethod that takes the activation descriptor, object and port as arguments; this method both registers and exports the object.
public ActivationID(Activator activator)The constructor for
ActivationIDtakes a single argument, activator, that specifies a remote reference to the activator responsible for activating the object associated with this identifier. An instance of
ActivationIDis globally unique.
activator- reference to the activator responsible for activating the object
UnsupportedOperationException- if and only if activation is not supported by this implementation
public Remote activate(boolean force) throws ActivationException, UnknownObjectException, RemoteExceptionActivate the object for this id.
force- if true, forces the activator to contact the group when activating the object (instead of returning a cached reference); if false, returning a cached value is acceptable.
- the reference to the active remote object
ActivationException- if activation fails
UnknownObjectException- if the object is unknown
RemoteException- if remote call fails
public int hashCode()Returns a hashcode for the activation id. Two identifiers that refer to the same remote object will have the same hash code.
public boolean equals(Object obj)Compares two activation ids for content equality. Returns true if both of the following conditions are true: 1) the unique identifiers equivalent (by content), and 2) the activator specified in each identifier refers to the same remote object.