java.rmi.server
Class RemoteServer

java.lang.Object
  extended byjava.rmi.server.RemoteObject
      extended byjava.rmi.server.RemoteServer
All Implemented Interfaces:
Remote, Serializable
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
Author:
Ann Wollrath
See Also:
Serialized Form

Field Summary
private static boolean logNull
           
private static long serialVersionUID
           
 
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
 

Field Detail

serialVersionUID

private static final long serialVersionUID
See Also:
Constant Field Values

logNull

private static boolean logNull
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 - 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. If out is null, call logging is turned off.

If there is a security manager, its checkPermission method will be invoked with a java.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 - 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)