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(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, newCall, 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 - 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 - if called outside of servicing a remote method invocation

Since:

JDK1.1