ServerRef (Java Platform SE 6) (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 SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2015, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

Scripting on this page tracks web page traffic, but does not change the content in any way.