java.rmi.server

Class UnicastRemoteObject

public class UnicastRemoteObject extends RemoteServer

This class obtains stub that communicates with the remote object.

Constructor Summary
protected	UnicastRemoteObject() Create and export new remote object without specifying the port value.
protected	UnicastRemoteObject(int port) Create and export the new remote object, making it available at the given port, local host.
protected	UnicastRemoteObject(int port, RMIClientSocketFactory clientSocketFactory, RMIServerSocketFactory serverSocketFactory) Create and export the new remote object, making it available at the given port, using sockets, produced by the specified factories.
protected	UnicastRemoteObject(RemoteRef ref)

Method Summary
Object	clone()
static RemoteStub	exportObject(Remote obj) Export object, making it available for the remote calls at the anonymous port.
static Remote	exportObject(Remote obj, int port) Export object, making it available for the remote calls at the specified port.
static Remote	exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) FIXME
static boolean	unexportObject(Remote obj, boolean force)

Constructor Detail

UnicastRemoteObject

protected UnicastRemoteObject()

Create and export new remote object without specifying the port value.

Throws: RemoteException if the attempt to export the object failed.

UnicastRemoteObject

protected UnicastRemoteObject(int port)

Create and export the new remote object, making it available at the given port, local host.

Parameters: port the port, on that the object should become available. Zero means anonymous port.

Throws: RemoteException if the attempt to export the object failed.

UnicastRemoteObject

protected UnicastRemoteObject(int port, RMIClientSocketFactory clientSocketFactory, RMIServerSocketFactory serverSocketFactory)

Create and export the new remote object, making it available at the given port, using sockets, produced by the specified factories.

Parameters: port the port, on that the object should become available. Zero means anonymous port. clientSocketFactory the client socket factory serverSocketFactory the server socket factory

Throws: RemoteException if the attempt to export the object failed.

UnicastRemoteObject

protected UnicastRemoteObject(RemoteRef ref)

Method Detail

exportObject

public static RemoteStub exportObject(Remote obj)

Export object, making it available for the remote calls at the anonymous port. This method returns the instance of the abstract class, not an interface. Hence it will not work with the proxy stubs that are supported since jdk 1.5 (such stubs cannot be derived from the RemoteStub). Only use this method if you are sure that the stub class will be accessible.

Parameters: obj the object being exported.

Returns: the remote object stub

Throws: RemoteException if the attempt to export the object failed.

exportObject

public static Remote exportObject(Remote obj, int port)

Export object, making it available for the remote calls at the specified port. Since jdk 1.5 this method does not longer require the stub class to be present. If such class is not found, the stub is replaced by the dynamically constructed proxy class. No attempt to find and load the stubs is made if the system property java.rmi.server.ignoreStubClasses is set to true (set to reduce the starting time if the stubs are surely not present and exclusively 1.2 RMI is used).

Parameters: obj the object being exported. port the remote object port

Returns: the remote object stub

Throws: RemoteException if the attempt to export the object failed.

exportObject

public static Remote exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)

FIXME

unexportObject

public static boolean unexportObject(Remote obj, boolean force)