java.rmi.activation
Class ActivationID

java.lang.Object
  java.rmi.activation.ActivationID

All Implemented Interfaces:

Serializable

public class ActivationID
extends Object
implements Serializable

Denotes the object that can be activated over time. The instance of the ActivationID for the given object can be obtained in the following ways:

• via Activatable.register(ActivationDesc)
• via Activatable constructor
• via Activatable.exportObject

An instance of the ActivationID has the UID as its component and hence is globally unique.

See Also:

Serialized Form

Constructor Summary

ActivationID(Activator an_activator)
Create a new instance with the given activator.

Method Summary

Remote	activate(boolean force) Activate the object.
boolean	equals(Object obj) Compares the activators for equality.
int	hashCode() Returns the hash code of the activator.
String	toString() Return the content based string representation.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ActivationID

public ActivationID(Activator an_activator)

Create a new instance with the given activator.

Parameters:

an_activator - tha activator that should activate the object.

Method Detail

activate

public Remote activate(boolean force)
                throws ActivationException,
                       UnknownObjectException,
                       RemoteException

Activate the object.

Parameters:

force - if true, always contact the group. Otherwise, the cached value may be returned.

Returns:

the activated object

Throws:

UnknownObjectException - if the object is unknown

ActivationException - if the activation has failed

RemoteException - if the remote call has failed

hashCode

public int hashCode()

Returns the hash code of the activator.

Overrides:

hashCode in class Object

Returns:

a hash code value.

equals

public boolean equals(Object obj)

Compares the activators for equality.

Overrides:

equals in class Object

Parameters:

obj - the other object.

Returns:

if this and other are considered equal.

toString

public String toString()

Return the content based string representation.

Overrides:

toString in class Object

Returns:

a string identifying this object.