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

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

Fields declared in interface RemoteRef

packagePrefix

Modifier and Type	Field	Description
`static final String`	`packagePrefix`	Initialize the server package prefix: assumes that the implementation of server ref classes (e.g., UnicastRef, UnicastServerRef) are located in the package defined by the prefix.

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 Externalizable

readExternal, writeExternal

Modifier and Type	Method	Description
`void`	`readExternal(ObjectInput in)`	The object implements the readExternal method to restore its contents by calling the methods of DataInput for primitive types and readObject for objects, strings and arrays.
`void`	`writeExternal(ObjectOutput out)`	The object implements the writeExternal method to save its contents by calling the methods of DataOutput for its primitive values or calling the writeObject method of ObjectOutput for objects, strings, and arrays.

Methods declared in interface RemoteRef

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

Modifier and Type	Method	Description
`void`	`done(RemoteCall call)`	Deprecated. 1.2 style stubs no longer use this method.
`String`	`getRefClass(ObjectOutput out)`	Returns the class name of the ref type to be serialized onto the stream 'out'.
`Object`	`invoke(Remote obj, Method method, Object[] params, long opnum)`	Invoke a method.
`void`	`invoke(RemoteCall call)`	Deprecated. 1.2 style stubs no longer use this method.
`RemoteCall`	`newCall(RemoteObject obj, Operation[] op, int opnum, long hash)`	Deprecated. 1.2 style stubs no longer use this method.
`boolean`	`remoteEquals(RemoteRef obj)`	Compares two remote objects for equality.
`int`	`remoteHashCode()`	Returns a hashcode for a remote object.
`String`	`remoteToString()`	Returns a String that represents the reference of this remote object.

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:

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.