|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.rmi.activation.ActivationDesc
public final class 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.
Activatable,
Serialized Form| Constructor Summary | |
|---|---|
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. |
|
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. |
|
| Method Summary | |
|---|---|
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 ActivationDescs. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
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 nonexistent
public 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 nonexistent
public 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 null
public 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 null| Method Detail |
|---|
public 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)
equals in class Objectobj - the Object to compare with
Hashtablepublic int hashCode()
ActivationDescs.
hashCode in class ObjectHashtable
|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.