|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.rmi.activation.ActivationDesc
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.
Constructor Summary | |
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(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(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 . |
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. |
Methods inherited from class java.lang.Object | |
clone , finalize , getClass , hashCode , 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.
Objects specified by a descriptor created by this constructor
will not restart automatically when the RMI activation daemon
starts, but will be activated on demand (via a method call to
the activatable object).
Note: as a side-effect of creating an ActivationDesc
,
if an ActivationGroup
for this VM is not currently
active, a default one is created. The default activation group
uses the java.rmi.RMISecurityManager
as a security
manager and upon reactivation will set the properties in the
activated group's VM to be the current set of properties. If
your application needs to use a different security manager,
it must set the group for the VM before creating a default
ActivationDesc
. See the method
ActivationGroup.createGroup
for details on how
to create an ActivationGroup
for the VM.
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.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.
Note: as a side-effect of creating an ActivationDesc
,
if an ActivationGroup
for this VM is not currently
active, a default one is created. The default activation group
uses the java.rmi.RMISecurityManager
as a security
manager and upon reactivation will set the properties in the
activated group's VM to be the current set of properties. If
your application needs to use a different security manager,
it must set the group for the VM before creating a default
ActivationDesc
. See the method
ActivationGroup.createGroup
for details on how
to create an ActivationGroup
for the VM.
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 when the activator
is restarted; if false, the object is activated on demand.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.
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.groupID
is nullpublic 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 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 when the activator
is restarted; if false, the object is activated on demand.groupID
is nullMethod Detail |
public ActivationGroupID getGroupID()
groupID
in the same virtual machine.public String getClassName()
public String getLocation()
public MarshalledObject getData()
public boolean getRestartMode()
public boolean equals(Object obj)
obj
- the Object to compare withHashtable
|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |