|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.rmi.server.RemoteObject java.rmi.server.RemoteServer java.rmi.server.UnicastRemoteObject
public class UnicastRemoteObject
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:
UnicastRemoteObject.exportObject(Remote)
method,
a stub class (typically pregenerated from the remote object's class
using the rmic
tool) is loaded and an instance of that stub
class is constructed as follows.
Remote
, then
the remote object's class is the root class; otherwise, the root class is
the most derived superclass of the remote object's class that directly
implements an interface that extends Remote
.
"_Stub"
.
RemoteStub
and must have a
public constructor that has one parameter, of type RemoteRef
.
RemoteRef
.
StubNotFoundException
is thrown.
java.rmi.server.ignoreStubClasses
is set to
"true"
(case insensitive), a Proxy
instance is constructed with the following
properties:
RemoteObjectInvocationHandler
instance constructed with a
RemoteRef
.
StubNotFoundException
will be thrown.
Field Summary |
---|
Fields inherited from class java.rmi.server.RemoteObject |
---|
ref |
Constructor Summary | |
---|---|
protected |
UnicastRemoteObject()
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 |
---|
finalize, getClass, notify, notifyAll, 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 calls
RemoteException
- if failed to export objectMethod Detail |
---|
public Object clone() throws CloneNotSupportedException
clone
in class Object
CloneNotSupportedException
- if clone failed due to
a RemoteException.Cloneable
public static RemoteStub exportObject(Remote obj) throws RemoteException
obj
- the remote object to be exported
RemoteException
- 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 on
RemoteException
- 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 calls
RemoteException
- 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 calls
NoSuchObjectException
- if the remote object is not
currently exported
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.