ServerRef (Java Platform SE 8 )
Keywords: java.rmi.server.ServerRef interface
Date: 2026-03-29

compact2, compact3
java.rmi.server

## Interface ServerRef

- All Superinterfaces:
    Externalizable, RemoteRef, Serializable

  Deprecated.
  No replacement. This interface is unused and is obsolete.

      @Deprecated
      public interface ServerRef
      extends RemoteRef

  A ServerRef represents the server-side handle for a remote object implementation.
  Since:
    JDK1.1

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static long` | `serialVersionUID` Deprecated. indicate compatibility with JDK 1.1.x version of class.

    - ### Fields inherited from interface java.rmi.server.RemoteRef

      `packagePrefix`

  - ### Method Summary

    All Methods Instance Methods Abstract Methods Deprecated Methods
    Modifier and Type | Method and Description
    --- | ---
    `RemoteStub` | `exportObject(Remote obj, Object data)` Deprecated. Creates a client stub object for the supplied Remote object.
    `String` | `getClientHost()` Deprecated. Returns the hostname of the current client.

    - ### Methods inherited from interface java.rmi.server.RemoteRef

      `done, getRefClass, invoke, invoke, newCall, remoteEquals, remoteHashCode, remoteToString`

    - ### Methods inherited from interface java.io.Externalizable

      `readExternal, writeExternal`

- - ### Field Detail

    - #### serialVersionUID

          static final long serialVersionUID

      Deprecated.
      indicate compatibility with JDK 1.1.x version of class.
      See Also:
        Constant Field Values

  - ### Method Detail

    - #### exportObject

          RemoteStub exportObject(Remote obj,
                                  Object data)
                           throws RemoteException

      Deprecated.
      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)
      Since:
        JDK1.1

    - #### getClientHost

          String getClientHost()
                        throws ServerNotActiveException

      Deprecated.
      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
      Since:
        JDK1.1

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, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.