java.lang.Object
java.rmi.activation.ActivationID
- All Implemented Interfaces:
Serializable
@Deprecated(forRemoval=true, since="15") public class ActivationID extends Object implements Serializable
Deprecated, for removal: This API element is subject to removal in a future version.
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 (a
RemoteRef
instance), and - a unique identifier (a
UID
instance) for the 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:
- 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:
- 1.2
- See Also:
Activatable
, Serialized Form
-
Constructor Summary
Constructors Constructor Description ActivationID(Activator activator)
Deprecated, for removal: This API element is subject to removal in a future version.The constructor forActivationID
takes a single argument, activator, that specifies a remote reference to the activator responsible for activating the object associated with this identifier. -
Method Summary
Modifier and Type Method Description Remote
activate(boolean force)
Deprecated, for removal: This API element is subject to removal in a future version.Activate the object for this id.boolean
equals(Object obj)
Deprecated, for removal: This API element is subject to removal in a future version.Compares two activation ids for content equality.int
hashCode()
Deprecated, for removal: This API element is subject to removal in a future version.Returns a hashcode for the activation id.
-
Constructor Details
-
ActivationID
Deprecated, for removal: This API element is subject to removal in a future version.The constructor forActivationID
takes a single argument, activator, that specifies a remote reference to the activator responsible for activating the object associated with this identifier. An instance ofActivationID
is globally unique.- Parameters:
activator
- reference to the activator responsible for activating the object- Throws:
UnsupportedOperationException
- if and only if activation is not supported by this implementation- Since:
- 1.2
-
-
Method Details
-
activate
public Remote activate(boolean force) throws ActivationException, UnknownObjectException, RemoteExceptionDeprecated, for removal: This API element is subject to removal in a future version.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 failsUnknownObjectException
- if the object is unknownRemoteException
- if remote call fails- Since:
- 1.2
-
hashCode
public int hashCode()Deprecated, for removal: This API element is subject to removal in a future version.Returns a hashcode for the activation id. Two identifiers that refer to the same remote object will have the same hash code. -
equals
Deprecated, for removal: This API element is subject to removal in a future version.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.
-
java.rmi.activation
package specification for further information.