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

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
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)