All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.rmi.activation.ActivationID

java.lang.Object
    |
    +----java.rmi.activation.ActivationID

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, and
a unique identifier for the object.

An activation id for an object can be obtained by registering an object with the activation system. Registration is accomplished in a few ways:

via the Activatable.register method
via the first Activatable constructor (that takes three arguments and both registers and exports the object, and
via the first Activatable.exportObject method that takes the activation descriptor, object and port as arguments; this method both registers and exports the object.

Since:
JDK1.2
See Also:
Activatable

ActivationID(Activator)
The constructor for ActivationID takes a single argument, activator, that specifies a remote reference to the activator responsible for activating the object associated with thisidentifier.

activate(boolean)
Activate the object for this id.
equals(Object)
Compares two activation ids for content equality.
hashCode()
Returns a hashcode for the activation id.

ActivationID
```
public ActivationID(Activator activator)
```
The constructor for ActivationID takes a single argument, activator, that specifies a remote reference to the activator responsible for activating the object associated with thisidentifier. An instance of ActivationID is globally unique.

Parameters:
activator - reference to the activator responsible for activating the object

activate
```
public Remote activate(boolean force) throws ActivationException, UnknownObjectException, RemoteException
```
Activate the object for this id.

Parameters:
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.
Returns:
the reference to the active remote object
Throws: ActivationException
if activation fails
Throws: UnknownObjectException
if the object is unknown
Throws: RemoteException
if remote call fails

hashCode
```
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.

Overrides:
hashCode in class Object
See Also:
Hashtable

equals
```
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.

Parameters:
obj - the Object to compare with
Returns:
true if these Objects are equal; false otherwise.
Overrides:
equals in class Object
See Also:
Hashtable
```
All Packages  Class Hierarchy  This Package  Previous  Next  Index  
```
Submit a bug or feature