java.lang.Object | |
↳ | java.rmi.activation.ActivationDesc |
An activation descriptor contains the information necessary to activate an object:
A descriptor registered with the activation system can be used to
recreate/activate the object specified by the descriptor. The
MarshalledObject
in the object's descriptor is passed
as the second argument to the remote object's constructor for
object to use during reinitialization/activation.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs an object descriptor for an object whose class name
is
className , that can be loaded from the
code location and whose initialization
information is data . | |||||||||||
Constructs an object descriptor for an object whose class name
is
className , that can be loaded from the
code location and whose initialization
information is data . | |||||||||||
Constructs an object descriptor for an object whose class name
is
className that can be loaded from the
code location and whose initialization
information is data . | |||||||||||
Constructs an object descriptor for an object whose class name
is
className that can be loaded from the
code location and whose initialization
information is data . |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Compares two activation descriptors for content equality.
| |||||||||||
Returns the class name for the object specified by this
descriptor.
| |||||||||||
Returns a "marshalled object" containing intialization/activation
data for the object specified by this descriptor.
| |||||||||||
Returns the group identifier for the object specified by this
descriptor.
| |||||||||||
Returns the code location for the object specified by
this descriptor.
| |||||||||||
Returns the "restart" mode of the object associated with
this activation descriptor.
| |||||||||||
Return the same hashCode for similar
ActivationDesc s. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Constructs an object descriptor for an object whose class name
is className
, that can be loaded from the
code location
and whose initialization
information is data
. If this form of the constructor
is used, the groupID
defaults to the current id for
ActivationGroup
for this VM. All objects with the
same ActivationGroupID
are activated in the same VM.
Note that objects specified by a descriptor created with this
constructor will only be activated on demand (by default, the restart
mode is false
). If an activatable object requires restart
services, use one of the ActivationDesc
constructors that
takes a boolean parameter, restart
.
This constructor will throw ActivationException
if
there is no current activation group for this VM. To create an
ActivationGroup
use the
ActivationGroup.createGroup
method.
className | the object's fully package qualified class name |
---|---|
location | the object's code location (from where the class is loaded) |
data | the object's initialization (activation) data contained in marshalled form. |
ActivationException | if the current group is nonexistent |
---|
Constructs an object descriptor for an object whose class name
is className
, that can be loaded from the
code location
and whose initialization
information is data
. If this form of the constructor
is used, the groupID
defaults to the current id for
ActivationGroup
for this VM. All objects with the
same ActivationGroupID
are activated in the same VM.
This constructor will throw ActivationException
if
there is no current activation group for this VM. To create an
ActivationGroup
use the
ActivationGroup.createGroup
method.
className | the object's fully package qualified class name |
---|---|
location | the object's code location (from where the class is loaded) |
data | the object's initialization (activation) data contained in marshalled form. |
restart | if true, the object is restarted (reactivated) when
either the activator is restarted or the object's activation group
is restarted after an unexpected crash; if false, the object is only
activated on demand. Specifying restart to be
true does not force an initial immediate activation of
a newly registered object; initial activation is lazy. |
ActivationException | if the current group is nonexistent |
---|
Constructs an object descriptor for an object whose class name
is className
that can be loaded from the
code location
and whose initialization
information is data
. All objects with the same
groupID
are activated in the same Java VM.
Note that objects specified by a descriptor created with this
constructor will only be activated on demand (by default, the restart
mode is false
). If an activatable object requires restart
services, use one of the ActivationDesc
constructors that
takes a boolean parameter, restart
.
groupID | the group's identifier (obtained from registering
ActivationSystem.registerGroup method). The group
indicates the VM in which the object should be activated. |
---|---|
className | the object's fully package-qualified class name |
location | the object's code location (from where the class is loaded) |
data | the object's initialization (activation) data contained in marshalled form. |
IllegalArgumentException | if groupID is null |
---|
Constructs an object descriptor for an object whose class name
is className
that can be loaded from the
code location
and whose initialization
information is data
. All objects with the same
groupID
are activated in the same Java VM.
groupID | the group's identifier (obtained from registering
ActivationSystem.registerGroup method). The group
indicates the VM in which the object should be activated. |
---|---|
className | the object's fully package-qualified class name |
location | the object's code location (from where the class is loaded) |
data | the object's initialization (activation) data contained in marshalled form. |
restart | if true, the object is restarted (reactivated) when
either the activator is restarted or the object's activation group
is restarted after an unexpected crash; if false, the object is only
activated on demand. Specifying restart to be
true does not force an initial immediate activation of
a newly registered object; initial activation is lazy. |
IllegalArgumentException | if groupID is null |
---|
Compares two activation descriptors for content equality.
obj | the Object to compare with |
---|
Returns the class name for the object specified by this descriptor.
Returns a "marshalled object" containing intialization/activation data for the object specified by this descriptor.
Returns the group identifier for the object specified by this
descriptor. A group provides a way to aggregate objects into a
single Java virtual machine. RMI creates/activates objects with
the same groupID
in the same virtual machine.
Returns the code location for the object specified by this descriptor.
Returns the "restart" mode of the object associated with this activation descriptor.
true
, the
activator does not force an initial immediate activation of
a newly registered object; initial activation is lazy.