ServerRef (Java 2 Platform SE 5.0) (original) (raw)

java.rmi.server

Interface ServerRef

All Superinterfaces:

Externalizable, RemoteRef, Serializable

public interface ServerRef

extends RemoteRef

A ServerRef represents the server-side handle for a remote object implementation.

Since:

JDK1.1

Field Summary
static long	serialVersionUID indicate compatibility with JDK 1.1.x version of class.

Fields inherited from interface java.rmi.server.RemoteRef
packagePrefix

Method Summary
RemoteStub	[exportObject](../../../java/rmi/server/ServerRef.html#exportObject%28java.rmi.Remote, java.lang.Object%29)(Remote obj,Object data) Creates a client stub object for the supplied Remote object.
String	getClientHost() Returns the hostname of the current client.

Methods inherited from interface java.rmi.server.RemoteRef
done, getRefClass, invoke, [invoke](../../../java/rmi/server/RemoteRef.html#invoke%28java.rmi.Remote, java.lang.reflect.Method, java.lang.Object[], long%29), [newCall](../../../java/rmi/server/RemoteRef.html#newCall%28java.rmi.server.RemoteObject, java.rmi.server.Operation[], int, long%29), remoteEquals, remoteHashCode, remoteToString

Methods inherited from interface java.io.Externalizable
readExternal, writeExternal

Field Detail

serialVersionUID

static final long serialVersionUID

indicate compatibility with JDK 1.1.x version of class.

See Also:

Constant Field Values

Method Detail

exportObject

RemoteStub exportObject(Remote obj, Object data) throws RemoteException

Creates a client stub object for the supplied Remote object. If the call completes successfully, the remote object should be able to accept incoming calls from clients.

Parameters:

obj - the remote object implementation

data - information necessary to export the object

Returns:

the stub for the remote object

Throws:

[RemoteException](../../../java/rmi/RemoteException.html "class in java.rmi") - if an exception occurs attempting to export the object (e.g., stub class could not be found)

Since:

JDK1.1

getClientHost

String getClientHost() throws ServerNotActiveException

Returns the hostname of the current client. When called from a thread actively handling a remote method invocation the hostname of the client is returned.

Returns:

the client's host name

Throws:

[ServerNotActiveException](../../../java/rmi/server/ServerNotActiveException.html "class in java.rmi.server") - if called outside of servicing a remote method invocation

Since:

JDK1.1

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.