RemoteServer (Java Platform SE 8 ) (original) (raw)

• java.lang.Object

• • 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](../../../java/rmi/server/RemoteObject.html "class in java.rmi.server")  
     `[ref](../../../java/rmi/server/RemoteObject.html#ref)`  

  • 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

  All Methods Static Methods Concrete Methods

  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 inherited from class java.rmi.server.[RemoteObject](../../../java/rmi/server/RemoteObject.html "class in java.rmi.server")  
     `[equals](../../../java/rmi/server/RemoteObject.html#equals-java.lang.Object-), [getRef](../../../java/rmi/server/RemoteObject.html#getRef--), [hashCode](../../../java/rmi/server/RemoteObject.html#hashCode--), [toString](../../../java/rmi/server/RemoteObject.html#toString--), [toStub](../../../java/rmi/server/RemoteObject.html#toStub-java.rmi.Remote-)`  
     * ### Methods inherited from class java.lang.[Object](../../../java/lang/Object.html "class in java.lang")  
     `[clone](../../../java/lang/Object.html#clone--), [finalize](../../../java/lang/Object.html#finalize--), [getClass](../../../java/lang/Object.html#getClass--), [notify](../../../java/lang/Object.html#notify--), [notifyAll](../../../java/lang/Object.html#notifyAll--), [wait](../../../java/lang/Object.html#wait--), [wait](../../../java/lang/Object.html#wait-long-), [wait](../../../java/lang/Object.html#wait-long-int-)`

• • Constructor Detail

     * #### RemoteServer  
     protected RemoteServer()  
     Constructs a `RemoteServer`.  
     Since:  
     JDK1.1  
     * #### RemoteServer  
     protected RemoteServer([RemoteRef](../../../java/rmi/server/RemoteRef.html "interface in java.rmi.server") ref)  
     Constructs a `RemoteServer` with the given reference type.  
     Parameters:  
     `ref` \- the remote reference  
     Since:  
     JDK1.1  

  • Method Detail

    * #### getClientHost  
    public static [String](../../../java/lang/String.html "class in java.lang") getClientHost()  
                                throws [ServerNotActiveException](../../../java/rmi/server/ServerNotActiveException.html "class in java.rmi.server")  
    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](../../../java/io/OutputStream.html "class in java.io") 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](../../../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()](../../../java/rmi/server/RemoteServer.html#getLog--)  
    * #### getLog  
    public static [PrintStream](../../../java/io/PrintStream.html "class in java.io") getLog()  
    Returns stream for the RMI call log.  
    Returns:  
    the call log  
    Since:  
    JDK1.1  
    See Also:  
    [setLog(java.io.OutputStream)](../../../java/rmi/server/RemoteServer.html#setLog-java.io.OutputStream-)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.