|
Préférences
Moteurs de recherche
|
|||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
java.rmi.activation
|
Field Summary |
---|
Fields inherited from class java.rmi.server.RemoteObject |
---|
ref |
Constructor Summary | |
---|---|
protected |
ActivationGroup(ActivationGroupID groupID)
Constructs an activation group with the given activation group identifier. |
Method Summary | |
---|---|
protected void |
activeObject(ActivationID id,
MarshalledObject<? extends Remote> mobj)
This protected method is necessary for subclasses to make the activeObject callback to the group's
monitor. |
abstract void |
activeObject(ActivationID id,
Remote obj)
The group's activeObject method is called when an
object is exported (either by Activatable object
construction or an explicit call to
Activatable.exportObject . |
static ActivationGroup |
createGroup(ActivationGroupID id,
ActivationGroupDesc desc,
long incarnation)
Create and set the activation group for the current VM. |
static ActivationGroupID |
currentGroupID()
Returns the current activation group's identifier. |
static ActivationSystem |
getSystem()
Returns the activation system for the VM. |
protected void |
inactiveGroup()
This protected method is necessary for subclasses to make the inactiveGroup callback to the group's
monitor. |
boolean |
inactiveObject(ActivationID id)
The group's inactiveObject method is called
indirectly via a call to the Activatable.inactive
method. |
static void |
setSystem(ActivationSystem system)
Set the activation system for the VM. |
Methods inherited from class java.rmi.server.UnicastRemoteObject |
---|
clone, exportObject, exportObject, exportObject, unexportObject |
Methods inherited from class java.rmi.server.RemoteServer |
---|
getClientHost, getLog, setLog |
Methods inherited from class java.rmi.server.RemoteObject |
---|
equals, getRef, hashCode, toString, toStub |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface java.rmi.activation.ActivationInstantiator |
---|
newInstance |
Constructor Detail |
---|
protected ActivationGroup(ActivationGroupID groupID) throws RemoteException
java.rmi.server.UnicastRemoteObject
.
groupID
- the group's identifier
RemoteException
- if this group could not be exportedMethod Detail |
---|
public boolean inactiveObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
inactiveObject
method is called
indirectly via a call to the Activatable.inactive
method. A remote object implementation must call
Activatable
's inactive
method when
that object deactivates (the object deems that it is no longer
active). If the object does not call
Activatable.inactive
when it deactivates, the
object will never be garbage collected since the group keeps
strong references to the objects it creates.
The group's inactiveObject
method unexports the
remote object from the RMI runtime so that the object can no
longer receive incoming RMI calls. An object will only be unexported
if the object has no pending or executing calls.
The subclass of ActivationGroup
must override this
method and unexport the object.
After removing the object from the RMI runtime, the group
must inform its ActivationMonitor
(via the monitor's
inactiveObject
method) that the remote object is
not currently active so that the remote object will be
re-activated by the activator upon a subsequent activation
request.
This method simply informs the group's monitor that the object is inactive. It is up to the concrete subclass of ActivationGroup to fulfill the additional requirement of unexporting the object.
id
- the object's activation identifier
UnknownObjectException
- if object is unknown (may already
be inactive)
RemoteException
- if call informing monitor fails
ActivationException
- if group is inactivepublic abstract void activeObject(ActivationID id, Remote obj) throws ActivationException, UnknownObjectException, RemoteException
activeObject
method is called when an
object is exported (either by Activatable
object
construction or an explicit call to
Activatable.exportObject
. The group must inform its
ActivationMonitor
that the object is active (via
the monitor's activeObject
method) if the group
hasn't already done so.
id
- the object's identifierobj
- the remote object implementation
UnknownObjectException
- if object is not registered
RemoteException
- if call informing monitor fails
ActivationException
- if group is inactivepublic static ActivationGroup createGroup(ActivationGroupID id, ActivationGroupDesc desc, long incarnation) throws ActivationException
createGroup
method when the Activator
initiates the
re-creation of an activation group in order to carry out
incoming activate
requests. A group must first be
registered with the ActivationSystem
before it can
be created via this method.
The group class specified by the
ActivationGroupDesc
must be a concrete subclass of
ActivationGroup
and have a public constructor that
takes two arguments: the ActivationGroupID
for the
group and the MarshalledObject
containing the
group's initialization data (obtained from the
ActivationGroupDesc
.
If the group class name specified in the
ActivationGroupDesc
is null
, then
this method will behave as if the group descriptor contained
the name of the default activation group implementation class.
Note that if your application creates its own custom
activation group, a security manager must be set for that
group. Otherwise objects cannot be activated in the group.
java.rmi.RMISecurityManager
is set by default.
If a security manager is already set in the group VM, this
method first calls the security manager's
checkSetFactory
method. This could result in a
SecurityException
. If your application needs to
set a different security manager, you must ensure that the
policy file specified by the group's
ActivationGroupDesc
grants the group the necessary
permissions to set a new security manager. (Note: This will be
necessary if your group downloads and sets a security manager).
After the group is created, the
ActivationSystem
is informed that the group is
active by calling the activeGroup
method which
returns the ActivationMonitor
for the group. The
application need not call activeGroup
independently since it is taken care of by this method.
Once a group is created, subsequent calls to the
currentGroupID
method will return the identifier
for this group until the group becomes inactive.
id
- the activation group's identifierdesc
- the activation group's descriptorincarnation
- the group's incarnation number (zero on group's
initial creation)
ActivationException
- if group already exists or if error
occurs during group creation
SecurityException
- if permission to create group is denied.
(Note: The default implementation of the security manager
checkSetFactory
method requires the RuntimePermission "setFactory")SecurityManager.checkSetFactory()
public static ActivationGroupID currentGroupID()
public static void setSystem(ActivationSystem system) throws ActivationException
getSystem
method attempts to obtain a reference to the
ActivationSystem
by looking up the name
"java.rmi.activation.ActivationSystem" in the Activator's
registry. By default, the port number used to look up the
activation system is defined by
ActivationSystem.SYSTEM_PORT
. This port can be overridden
by setting the property java.rmi.activation.port
.
If there is a security manager, this method first
calls the security manager's checkSetFactory
method.
This could result in a SecurityException.
system
- remote reference to the ActivationSystem
ActivationException
- if activation system is already set
SecurityException
- if permission to set the activation system is denied.
(Note: The default implementation of the security manager
checkSetFactory
method requires the RuntimePermission "setFactory")getSystem()
,
SecurityManager.checkSetFactory()
public static ActivationSystem getSystem() throws ActivationException
setSystem
method. If the
activation system is not set via the setSystem
method, then the getSystem
method attempts to
obtain a reference to the ActivationSystem
by
looking up the name "java.rmi.activation.ActivationSystem" in
the Activator's registry. By default, the port number used to
look up the activation system is defined by
ActivationSystem.SYSTEM_PORT
. This port can be
overridden by setting the property
java.rmi.activation.port
.
ActivationException
- if activation system cannot be
obtained or is not bound
(means that it is not running)setSystem(java.rmi.activation.ActivationSystem)
protected void activeObject(ActivationID id, MarshalledObject<? extends Remote> mobj) throws ActivationException, UnknownObjectException, RemoteException
activeObject
callback to the group's
monitor. The call is simply forwarded to the group's
ActivationMonitor
.
id
- the object's identifiermobj
- a marshalled object containing the remote object's stub
UnknownObjectException
- if object is not registered
RemoteException
- if call informing monitor fails
ActivationException
- if an activation error occursprotected void inactiveGroup() throws UnknownGroupException, RemoteException
inactiveGroup
callback to the group's
monitor. The call is simply forwarded to the group's
ActivationMonitor
. Also, the current group
for the VM is set to null.
UnknownGroupException
- if group is not registered
RemoteException
- if call informing monitor fails