Java Platform 1.2

java.rmi.server
Interface ServerRef


public abstract 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 class java.rmi.server.RemoteRef
packagePrefix, serialVersionUID
 
Fields inherited from class java.io.Serializable
serialVersionUID
 
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

public static final long serialVersionUID
indicate compatibility with JDK 1.1.x version of class
Method Detail

exportObject

public 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

public 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

Java Platform 1.2

Submit a bug or feature Version 1.2 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.