public interface

ServerRef

implements RemoteRef
java.rmi.server.ServerRef
Known Indirect Subclasses

Class Overview

A ServerRef represents the server-side handle for a remote object implementation.

Summary

Constants
long serialVersionUID indicate compatibility with JDK 1.1.x version of class.
[Expand]
Inherited Constants
From interface java.rmi.server.RemoteRef
Public Methods
abstract RemoteStub exportObject(Remote obj, Object data)
Creates a client stub object for the supplied Remote object.
abstract String getClientHost()
Returns the hostname of the current client.
[Expand]
Inherited Methods
From interface java.io.Externalizable
From interface java.rmi.server.RemoteRef

Constants

public static final long serialVersionUID

indicate compatibility with JDK 1.1.x version of class.

Constant Value: -4557750989390278438 (0xc0bf9d9f86b510da)

Public Methods

public abstract RemoteStub exportObject (Remote obj, Object data)

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)

public abstract String getClientHost ()

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