API java : ServerRef

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

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