Activatable JDK 1.6)

Constructors

protected Activatable (ActivationID id, int port) throws RemoteException

Constructor used to activate/export the object on a specified port.

protected Activatable (ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException

Constructor used to activate/export the object on a specified port.

protected Activatable (String location, MarshalledObject<Object> data, boolean restart, int port) throws ActivationException RemoteException

Constructs an activatable remote object by registering an activation descriptor (with the specified location, data, and restart mode) for this object, and exporting the object with the specified port.

protected Activatable (String location, MarshalledObject<Object> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws ActivationException RemoteException

Methods

Hide/Show inherited methods

public boolean equals (Object obj) [Inherited From RemoteObject]

Compares two remote objects for equality.

Compares two remote objects for equality.
Returns a boolean that indicates whether this remote object is
equivalent to the specified Object. This method is used when a
remote object is stored in a hashtable.
If the specified Object is not itself an instance of RemoteObject,
then this method delegates by returning the result of invoking the
equals method of its parameter with this remote object
as the argument.
Returns: true if these Objects are equal; false otherwise.
Parameters:
- obj - the Object to compare with
See Also: Hashtable,

publicstatic Remote exportObject (Remote obj, ActivationID id, int port) throws RemoteException

Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls.

Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls. The object is exported on an anonymous port, if port is zero.

During activation, this exportObject method should be invoked explicitly by an "activatable" object, that does not extend the Activatable class. There is no need for objects that do extend the Activatable class to invoke this method directly because the object is exported during construction.
Returns: the stub for the activatable remote object
Parameters:
- obj - the remote object implementation
- id - the object's activation identifier
- port - the port on which the object is exported (an anonymous port is used if port=0)
Throws:
- RemoteException - if object export fails
Since: 1.2

publicstatic Remote exportObject (Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException

Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls.

Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls. The object is exported on an anonymous port, if port is zero.

During activation, this exportObject method should be invoked explicitly by an "activatable" object, that does not extend the Activatable class. There is no need for objects that do extend the Activatable class to invoke this method directly because the object is exported during construction.
Returns: the stub for the activatable remote object
Parameters:
- obj - the remote object implementation
- id - the object's activation identifier
- port - the port on which the object is exported (an anonymous port is used if port=0)
- csf - the client-side socket factory for making calls to the remote object
- ssf - the server-side socket factory for receiving remote calls
Throws:
- RemoteException - if object export fails
Since: 1.2

publicstatic ActivationID exportObject (Remote obj, String location, MarshalledObject<Object> data, boolean restart, int port) throws ActivationException RemoteException

Registers an activation descriptor (with the specified location, data, and restart mode) for the specified object, and exports that object with the specified port.

publicstatic ActivationID exportObject (Remote obj, String location, MarshalledObject<Object> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws ActivationException RemoteException

Registers an activation descriptor (with the specified location, data, and restart mode) for the specified object, and exports that object with the specified port, and the specified client and server socket factories.

Note: Using this method (as well as the Activatable constructors that both register and export an activatable remote object) is strongly discouraged because the actions of registering and exporting the remote object are not guaranteed to be atomic. Instead, an application should register an activation descriptor and export a remote object separately, so that exceptions can be handled properly.

This method first registers an activation descriptor for the specified object as follows. It obtains the activation system by invoking the method ActivationGroup.getSystem. This method then obtains an ActivationID for the object by invoking the activation system's registerObject method with an ActivationDesc constructed with the specified object's class name, and the specified location, data, and restart mode. If an exception occurs obtaining the activation system or registering the activation descriptor, that exception is thrown to the caller.

Next, this method exports the object by invoking the exportObject method with the specified remote object, the activation identifier obtained from registration, the specified port, and the specified client and server socket factories. If an exception occurs exporting the object, this method attempts to unregister the activation identifier (obtained from registration) by invoking the activation system's unregisterObject method with the activation identifier. If an exception occurs unregistering the identifier, that exception is ignored, and the original exception that occurred exporting the object is thrown to the caller.

Finally, this method invokes the activeObject method on the activation group in this VM with the activation identifier and the specified remote object, and returns the activation identifier to the caller.
Returns: the activation identifier obtained from registering the descriptor with the activation system
Parameters:
- obj - the object being exported
- location - the object's code location
- data - the object's bootstrapping data
- 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.
- port - the port on which the object is exported (an anonymous port is used if port=0)
- csf - the client-side socket factory for making calls to the remote object
- ssf - the server-side socket factory for receiving remote calls
Throws:
- ActivationException - if activation group is not active
- RemoteException - if object registration or export fails
Since: 1.2

publicstatic String getClientHost () throws ServerNotActiveException [Inherited From RemoteServer]

Returns a string representation of the client host for the remote method invocation being processed in the current thread.

protected ActivationID getID ()

Returns the object's activation identifier.

publicstatic PrintStream getLog () [Inherited From RemoteServer]

Returns stream for the RMI call log.

public RemoteRef getRef () [Inherited From RemoteObject]

Returns the remote reference for the remote object.

public int hashCode () [Inherited From RemoteObject]

Returns a hashcode for a remote object.

publicstatic boolean inactive (ActivationID id) throws UnknownObjectException ActivationException RemoteException

Informs the system that the object with the corresponding activation id is currently inactive.

Informs the system that the object with the corresponding activation
id is currently inactive. If the object is currently
active, the object is "unexported" from the RMI runtime (only if
there are no pending or in-progress calls)
so the that it can no longer receive incoming calls. This call
informs this VM's ActivationGroup that the object is inactive,
that, in turn, informs its ActivationMonitor. If this call
completes successfully, a subsequent activate request to the activator
will cause the object to reactivate. The operation may still
succeed if the object is considered active but has already
unexported itself.
Returns: true if the operation succeeds (the operation will succeed if the object in currently known to be active and is either already unexported or is currently exported and has no pending/executing calls); false is returned if the object has pending/executing calls in which case it cannot be deactivated
Parameters:
- id - the object's activation identifier
Throws:
- UnknownObjectException - if object is not known (it may already be inactive)
- ActivationException - if group is not active
- RemoteException - if call informing monitor fails
Since: 1.2

publicstatic Remote register (ActivationDesc desc) throws UnknownGroupException ActivationException RemoteException

Register an object descriptor for an activatable remote
object so that is can be activated on demand.
Returns: the stub for the activatable remote object
Parameters:
- desc - the object's descriptor
Throws:
- UnknownGroupException - if group id in desc is not registered with the activation system
- ActivationException - if activation system is not running
- RemoteException - if remote call fails
Since: 1.2

publicstatic void setLog (OutputStream out) [Inherited From RemoteServer]

Log RMI calls to the output stream out.

Log RMI calls to the output stream out. If out is null, call logging is turned off.

If there is a security manager, its checkPermission method will be invoked with a java.util.logging.LoggingPermission("control") permission; this could result in a SecurityException.
Parameters:
- out - the output stream to which RMI calls should be logged
Throws:
- SecurityException - if there is a security manager and the invocation of its checkPermission method fails
Since: JDK1.1
See Also: RemoteServer.getLog(),

public String toString () [Inherited From RemoteObject]

Returns a String that represents the value of this remote object.

publicstatic Remote toStub (Remote obj) throws NoSuchObjectException [Inherited From RemoteObject]

Returns the stub for the remote object obj passed as a parameter.

Returns the stub for the remote object obj passed
as a parameter. This operation is only valid after
the object has been exported.
Returns: the stub for the remote object, obj.
Parameters:
- obj - the remote object whose stub is needed
Throws:
- NoSuchObjectException - if the stub for the remote object could not be found.
Since: 1.2

publicstatic boolean unexportObject (Remote obj, boolean force) throws NoSuchObjectException

Remove the remote object, obj, from the RMI runtime.

publicstatic void unregister (ActivationID id) throws UnknownObjectException ActivationException RemoteException

Revokes previous registration for the activation descriptor associated with id.

Revokes previous registration for the activation descriptor
associated with id. An object can no longer be
activated via that id.
Parameters:
- id - the object's activation identifier
Throws:
- UnknownObjectException - if object (id) is unknown
- ActivationException - if activation system is not running
- RemoteException - if remote call to activation system fails
Since: 1.2