ServerRef (Java Platform SE 6)

This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.

Overview

Package

Class

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

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.

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`

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 class java.rmi.server.RemoteRef
`done, getRefClass, invoke, invoke, newCall, remoteEquals, remoteHashCode, remoteToString`

Methods inherited from class 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)

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