| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public class UnicastRemoteObject extends RemoteServer
Used for exporting a remote object with JRMP and obtaining a stub that communicates to the remote object.
For the constructors and static exportObject
methods
below, the stub for a remote object being exported is obtained as
follows:
rmic
tool) is loaded and an instance of that stub
class is constructed as follows.
Remote
.
"_Stub"
.
java.rmi.server.ignoreStubClasses
is set to
"true"
(case insensitive), a {@link
java.lang.reflect.Proxy} instance is constructed with the following
properties:
Field Summary |
---|
Fields inherited from class java.rmi.server.RemoteObject |
---|
ref |
Constructor Summary | |
---|---|
protected |
Creates and exports a new UnicastRemoteObject object using an anonymous port. |
protected |
UnicastRemoteObject(int port) Creates and exports a new UnicastRemoteObject object using the particular supplied port. |
protected |
UnicastRemoteObject(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Creates and exports a new UnicastRemoteObject object using the particular supplied port and socket factories. |
Method Summary | |
---|---|
Object |
clone() Returns a clone of the remote object that is distinct from the original. |
static RemoteStub |
exportObject(Remote obj) Exports the remote object to make it available to receive incoming calls using an anonymous port. |
static Remote |
exportObject(Remote obj, int port) Exports the remote object to make it available to receive incoming calls, using the particular supplied port. |
static Remote |
exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Exports the remote object to make it available to receive incoming calls, using a transport specified by the given socket factory. |
static boolean |
unexportObject(Remote obj, boolean force) Removes the remote object, obj, from the RMI runtime. |
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 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected UnicastRemoteObject() throws RemoteException
RemoteException
- if failed to export objectprotected UnicastRemoteObject(int port) throws RemoteException
port
- the port number on which the remote object receives calls
(if port
is zero, an anonymous port is chosen)RemoteException
- if failed to export objectprotected UnicastRemoteObject(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException
port
- the port number on which the remote object receives calls
(if port
is zero, an anonymous port is chosen)csf
- the client-side socket factory for making calls to the
remote objectssf
- the server-side socket factory for receiving remote callsRemoteException
- if failed to export objectMethod Detail |
---|
public Object clone() throws CloneNotSupportedException
clone
in class Object
CloneNotSupportedException
- if clone failed due to
a RemoteException.public static RemoteStub exportObject(Remote obj) throws RemoteException
obj
- the remote object to be exportedRemoteException
- if export failspublic static Remote exportObject(Remote obj, int port) throws RemoteException
obj
- the remote object to be exportedport
- the port to export the object onRemoteException
- if export failspublic static Remote exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException
obj
- the remote object to be exportedport
- the port to export the object oncsf
- the client-side socket factory for making calls to the
remote objectssf
- the server-side socket factory for receiving remote callsRemoteException
- if export failspublic static boolean unexportObject(Remote obj, boolean force) throws NoSuchObjectException
obj
- the remote object to be unexportedforce
- if true, unexports the object even if there are
pending or in-progress calls; if false, only unexports the object
if there are no pending or in-progress callsNoSuchObjectException
- if the remote object is not
currently exported
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |