Class RemoteServer

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

All Implemented Interfaces:

Serializable, Remote

Direct Known Subclasses:

UnicastRemoteObject

public abstract class RemoteServer
extends RemoteObject

The RemoteServer class is the common superclass to server implementations and provides the framework to support a wide range of remote reference semantics. Specifically, the functions needed to create and export remote objects (i.e. to make them remotely available) are provided abstractly by RemoteServer and concretely by its subclass(es).

Since:

1.1

See Also:

• Serialized Form

Field Summary

Fields declared in class RemoteObject

ref

Modifier and Type	Field	Description
protected RemoteRef	ref	The object's remote reference.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RemoteServer()	Constructs a RemoteServer.
protected	RemoteServer(RemoteRef ref)	Constructs a RemoteServer with the given reference type.

Method Summary

Modifier and Type	Method	Description
static String	getClientHost()	Returns a string representation of the client host for the remote method invocation being processed in the current thread.
static PrintStream	getLog()	Returns stream for the RMI call log.
static void	setLog(OutputStream out)	Log RMI calls to the output stream out.

Methods declared in class RemoteObject

equals, getRef, hashCode, toString, toStub

Modifier and Type	Method	Description
boolean	equals(Object obj)	Compares two remote objects for equality.
RemoteRef	getRef()	Returns the remote reference for the remote object.
int	hashCode()	Returns a hashcode for a remote object.
String	toString()	Returns a String that represents the value of this remote object.
static Remote	toStub(Remote obj)	Returns the stub for the remote object obj passed as a parameter.

Methods declared in class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Modifier and Type	Method	Description
protected Object	clone()	Creates and returns a copy of this object.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release.
final Class<?>	getClass()	Returns the runtime class of this Object.
final void	notify()	Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll()	Wakes up all threads that are waiting on this object's monitor.
final void	wait()	Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
final void	wait(long timeoutMillis)	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
final void	wait(long timeoutMillis, int nanos)	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

Constructor Details

RemoteServer

protected RemoteServer()

Constructs a RemoteServer.

Since:

1.1

RemoteServer

protected RemoteServer(RemoteRef ref)

Constructs a RemoteServer with the given reference type.

Parameters:

ref - the remote reference

Since:

1.1

Method Details

getClientHost

public static String getClientHost()
                            throws ServerNotActiveException

Returns a string representation of the client host for the remote method invocation being processed in the current thread.

Returns:

a string representation of the client host

Throws:

ServerNotActiveException - if no remote method invocation is being processed in the current thread

Since:

1.1

setLog

public static void setLog(OutputStream out)

Log RMI calls to the output stream out. If out is null, call logging is turned off.

Parameters:

out - the output stream to which RMI calls should be logged

Since:

1.1

See Also:

• getLog()

getLog

public static PrintStream getLog()

Returns stream for the RMI call log.

Returns:

the call log

Since:

1.1

See Also:

• setLog(OutputStream)