java.rmi.activation
Class ActivationID

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.rmi.activation.ActivationID
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable

public class ActivationID
extends Object sample code for java.lang.Object definition code for java.lang.Object
implements Serializable sample code for java.io.Serializable definition code for java.io.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:

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

Since:
1.2
See Also:
Activatable sample code for java.rmi.activation.Activatable definition code for java.rmi.activation.Activatable , Serialized Form

Constructor Summary
ActivationID sample code for java.rmi.activation.ActivationID.ActivationID(java.rmi.activation.Activator) definition code for java.rmi.activation.ActivationID.ActivationID(java.rmi.activation.Activator) (Activator sample code for java.rmi.activation.Activator definition code for java.rmi.activation.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 this identifier.
 
Method Summary
 Remote sample code for java.rmi.Remote definition code for java.rmi.Remote activate sample code for java.rmi.activation.ActivationID.activate(boolean) definition code for java.rmi.activation.ActivationID.activate(boolean) (boolean force)
          Activate the object for this id.
 boolean equals sample code for java.rmi.activation.ActivationID.equals(java.lang.Object) definition code for java.rmi.activation.ActivationID.equals(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  obj)
          Compares two activation ids for content equality.
 int hashCode sample code for java.rmi.activation.ActivationID.hashCode() definition code for java.rmi.activation.ActivationID.hashCode() ()
          Returns a hashcode for the activation id.
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , toString sample code for java.lang.Object.toString() definition code for java.lang.Object.toString() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Constructor Detail

ActivationID sample code for java.rmi.activation.ActivationID(java.rmi.activation.Activator) definition code for java.rmi.activation.ActivationID(java.rmi.activation.Activator)

public ActivationID(Activator sample code for java.rmi.activation.Activator definition code for java.rmi.activation.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 this identifier. An instance of ActivationID is globally unique.

Parameters:
activator - reference to the activator responsible for activating the object
Since:
1.2
Method Detail

activate sample code for java.rmi.activation.ActivationID.activate(boolean) definition code for java.rmi.activation.ActivationID.activate(boolean)

public Remote sample code for java.rmi.Remote definition code for java.rmi.Remote  activate(boolean force)
                throws ActivationException sample code for java.rmi.activation.ActivationException definition code for java.rmi.activation.ActivationException ,
                       UnknownObjectException sample code for java.rmi.activation.UnknownObjectException definition code for java.rmi.activation.UnknownObjectException ,
                       RemoteException sample code for java.rmi.RemoteException definition code for java.rmi.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 sample code for java.rmi.activation.ActivationException definition code for java.rmi.activation.ActivationException - if activation fails
UnknownObjectException sample code for java.rmi.activation.UnknownObjectException definition code for java.rmi.activation.UnknownObjectException - if the object is unknown
RemoteException sample code for java.rmi.RemoteException definition code for java.rmi.RemoteException - if remote call fails
Since:
1.2

hashCode sample code for java.rmi.activation.ActivationID.hashCode() definition code for java.rmi.activation.ActivationID.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 sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() in class Object sample code for java.lang.Object definition code for java.lang.Object
Returns:
a hash code value for this object.
Since:
1.2
See Also:
Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable

equals sample code for java.rmi.activation.ActivationID.equals(java.lang.Object) definition code for java.rmi.activation.ActivationID.equals(java.lang.Object)

public boolean equals(Object sample code for java.lang.Object definition code for java.lang.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.

Overrides:
equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) in class Object sample code for java.lang.Object definition code for java.lang.Object
Parameters:
obj - the Object to compare with
Returns:
true if these Objects are equal; false otherwise.
Since:
1.2
See Also:
Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable