Class RemoteObject
java.lang.Object
java.rmi.server.RemoteObject
- All Implemented Interfaces:
Serializable
,Remote
- Direct Known Subclasses:
RemoteObjectInvocationHandler
,RemoteServer
,RemoteStub
The
RemoteObject
class implements the
java.lang.Object
behavior for remote objects.
RemoteObject
provides the remote semantics of Object by
implementing methods for hashCode, equals, and toString.- Since:
- 1.1
- See Also:
-
Field Summary
-
Constructor Summary
ModifierConstructorDescriptionprotected
Creates a remote object.protected
RemoteObject
(RemoteRef newref) Creates a remote object, initialized with the specified remote reference. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Compares two remote objects for equality.getRef()
Returns the remote reference for the remote object.int
hashCode()
Returns a hashcode for a remote object.toString()
Returns a String that represents the value of this remote object.static Remote
Returns the stub for the remote objectobj
passed as a parameter.
-
Field Details
-
ref
The object's remote reference.
-
-
Constructor Details
-
RemoteObject
protected RemoteObject()Creates a remote object. -
RemoteObject
Creates a remote object, initialized with the specified remote reference.- Parameters:
newref
- remote reference
-
-
Method Details
-
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
RemoteObject
class ensures serialization portability of its instances' remote references through the behavior of its customwriteObject
andreadObject
methods. An instance ofRemoteRef
should not be serialized outside of itsRemoteObject
wrapper instance or the result may be unportable.- Returns:
- remote reference for the remote object
- Since:
- 1.2
-
toStub
Returns the stub for the remote objectobj
passed 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
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 theequals
method of its parameter with this remote object as the argument. -
toString
-