java.rmi.activation
Class ActivationID

java.lang.Object
  extended by 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:

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:
the hash code for this Object
See Also:
Object.equals(Object), System.identityHashCode(Object)

equals

public boolean equals(Object obj)
Compares the activators for equality.

Overrides:
equals in class Object
Parameters:
obj - the Object to compare to
Returns:
whether this Object is semantically equal to another
See Also:
Object.hashCode()

toString

public String toString()
Return the content based string representation.

Overrides:
toString in class Object
Returns:
the String representing this Object, which may be null
See Also:
Object.getClass(), Object.hashCode(), Class.getName(), Integer.toHexString(int)