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