RemoteServer (Java 2 Platform SE 5.0) (original) (raw)

java.rmi.server

Class RemoteServer

java.lang.Object extended by java.rmi.server.RemoteObject java.rmi.server.RemoteServer

All Implemented Interfaces:

Serializable, Remote

Direct Known Subclasses:

Activatable, 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:

JDK1.1

See Also:

Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject
ref

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

Method Summary
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 inherited from class java.rmi.server.RemoteObject
equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, [wait](../../../java/lang/Object.html#wait%28long, int%29)

Constructor Detail

RemoteServer

protected RemoteServer()

Constructs a RemoteServer.

Since:

JDK1.1

RemoteServer

protected RemoteServer(RemoteRef ref)

Constructs a RemoteServer with the given reference type.

Parameters:

ref - the remote reference

Since:

JDK1.1

Method Detail

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](../../../java/rmi/server/ServerNotActiveException.html "class in java.rmi.server") - if no remote method invocation is being processed in the current thread

Since:

JDK1.1

setLog

public static void setLog(OutputStream out)

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

If there is a security manager, itscheckPermission method will be invoked with ajava.util.logging.LoggingPermission("control") permission; this could result in a SecurityException.

Parameters:

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

Throws:

[SecurityException](../../../java/lang/SecurityException.html "class in java.lang") - if there is a security manager and the invocation of its checkPermission method fails

Since:

JDK1.1

See Also:

getLog()

getLog

public static PrintStream getLog()

Returns stream for the RMI call log.

Returns:

the call log

Since:

JDK1.1

See Also:

setLog(java.io.OutputStream)

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.