Serializable
public final class ActivationDesc extends Object implements Serializable
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.
Activatable
,
Serialized FormConstructor | Description |
---|---|
ActivationDesc(String className,
String location,
MarshalledObject<?> 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 . |
ActivationDesc(String className,
String location,
MarshalledObject<?> data,
boolean restart) |
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 . |
ActivationDesc(ActivationGroupID groupID,
String className,
String location,
MarshalledObject<?> 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 . |
ActivationDesc(ActivationGroupID groupID,
String className,
String location,
MarshalledObject<?> data,
boolean restart) |
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 . |
Modifier and Type | Method | Description |
---|---|---|
boolean |
equals(Object obj) |
Compares two activation descriptors for content equality.
|
String |
getClassName() |
Returns the class name for the object specified by this
descriptor.
|
MarshalledObject<?> |
getData() |
Returns a "marshalled object" containing intialization/activation
data for the object specified by this descriptor.
|
ActivationGroupID |
getGroupID() |
Returns the group identifier for the object specified by this
descriptor.
|
String |
getLocation() |
Returns the code location for the object specified by
this descriptor.
|
boolean |
getRestartMode() |
Returns the "restart" mode of the object associated with
this activation descriptor.
|
int |
hashCode() |
Return the same hashCode for similar
ActivationDesc s. |
public ActivationDesc(String className, String location, MarshalledObject<?> data) throws ActivationException
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 namelocation
- 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 nonexistentUnsupportedOperationException
- if and only if activation is
not supported by this implementationpublic ActivationDesc(String className, String location, MarshalledObject<?> data, boolean restart) throws ActivationException
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 namelocation
- 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 nonexistentUnsupportedOperationException
- if and only if activation is
not supported by this implementationpublic ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data)
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 namelocation
- 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 nullUnsupportedOperationException
- if and only if activation is
not supported by this implementationpublic ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data, boolean restart)
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 namelocation
- 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 nullUnsupportedOperationException
- if and only if activation is
not supported by this implementationpublic ActivationGroupID getGroupID()
groupID
in the same virtual machine.public String getClassName()
public String getLocation()
public MarshalledObject<?> getData()
public boolean getRestartMode()
true
, the
activator does not force an initial immediate activation of
a newly registered object; initial activation is lazy.public boolean equals(Object obj)
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-internal+0-adhoc.mlchung.jdk9-jdeps