ServerRef (Java SE 22 & JDK 22)
Description: declaration: module: java.rmi, package: java.rmi.server, interface: ServerRef
Keywords: java.rmi.server.ServerRef interface

Module java.rmi
Package java.rmi.server

# Interface ServerRef

All Superinterfaces:
  `Externalizable`, `RemoteRef`, `Serializable`

@Deprecated public interface ServerRef extends RemoteRef
Deprecated.
No replacement. This interface is unused and is obsolete.
A ServerRef represents the server-side handle for a remote object implementation.

Since:
  1.1

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final long`
  `serialVersionUID`
  Deprecated.
  A `serialVersionUID` field in an interface is ineffectual.

  ### Fields declared in interface java.rmi.server.RemoteRef

  `packagePrefix`

- ## Method Summary

  Modifier and Type
  Method
  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 declared in interface java.io.Externalizable

  `readExternal, writeExternal`

  ### Methods declared in interface java.rmi.server.RemoteRef

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

- ## Field Details

  - ### serialVersionUID

    @Deprecated static final long serialVersionUID
    Deprecated.
    A `serialVersionUID` field in an interface is ineffectual. Do not use; no replacement.
    indicate compatibility with JDK 1.1.x version of class.
    See Also:
      - Constant Field Values

- ## Method Details

  - ### 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:
      1.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:
      1.1