Class RemoteObject
- java.lang.Object
-
- java.rmi.server.RemoteObject
-
- All Implemented Interfaces:
- Serializable, Remote
- Direct Known Subclasses:
- RemoteObjectInvocationHandler, RemoteServer, RemoteStub
public abstract class RemoteObject extends Object implements Remote, Serializable
TheRemoteObjectclass implements thejava.lang.Objectbehavior for remote objects.RemoteObjectprovides the remote semantics of Object by implementing methods for hashCode, equals, and toString.- Since:
- JDK1.1
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field and Description protected RemoteRefrefThe object's remote reference.
-
Constructor Summary
Constructors Modifier Constructor and Description protectedRemoteObject()Creates a remote object.protectedRemoteObject(RemoteRef newref)Creates a remote object, initialized with the specified remote reference.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method and Description booleanequals(Object obj)Compares two remote objects for equality.RemoteRefgetRef()Returns the remote reference for the remote object.inthashCode()Returns a hashcode for a remote object.StringtoString()Returns a String that represents the value of this remote object.static RemotetoStub(Remote obj)Returns the stub for the remote objectobjpassed as a parameter.
-
-
-
Field Detail
ref
protected transient RemoteRef ref
The object's remote reference.
-
Constructor Detail
RemoteObject
protected RemoteObject()
Creates a remote object.
RemoteObject
protected RemoteObject(RemoteRef newref)
Creates a remote object, initialized with the specified remote reference.- Parameters:
-
newref- remote reference
-
Method Detail
getRef
public RemoteRef getRef()
Returns the remote reference for the remote object.Note: The object returned from this method may be an instance of an implementation-specific class. The
RemoteObjectclass ensures serialization portability of its instances' remote references through the behavior of its customwriteObjectandreadObjectmethods. An instance ofRemoteRefshould not be serialized outside of itsRemoteObjectwrapper instance or the result may be unportable.- Returns:
- remote reference for the remote object
- Since:
- 1.2
toStub
public static Remote toStub(Remote obj) throws NoSuchObjectException
Returns the stub for the remote objectobjpassed as a parameter. This operation is only valid after the object has been exported.- Parameters:
-
obj- the remote object whose stub is needed - Returns:
-
the stub for the remote object,
obj. - Throws:
-
NoSuchObjectException- if the stub for the remote object could not be found. - Since:
- 1.2
hashCode
public int hashCode()
Returns a hashcode for a remote object. Two remote object stubs that refer to the same remote object will have the same hash code (in order to support remote objects as keys in hash tables).
equals
public boolean equals(Object obj)
Compares two remote objects for equality. Returns a boolean that indicates whether this remote object is equivalent to the specified Object. This method is used when a remote object is stored in a hashtable. If the specified Object is not itself an instance of RemoteObject, then this method delegates by returning the result of invoking theequalsmethod of its parameter with this remote object as the argument.
-
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, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
