Java Platform 1.2

java.rmi.server
Class RemoteObject

java.lang.Object
  |
  +--java.rmi.server.RemoteObject
Direct Known Subclasses:
RemoteServer, RemoteStub

public abstract class RemoteObject
extends Object
implements Remote, Serializable

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:
JDK1.1
See Also:
Serialized Form

Field Summary
protected  RemoteRef ref
          the objects remote reference
 
Constructor Summary
protected RemoteObject()
          Creates a remote object.
protected RemoteObject(RemoteRef newref)
          Creates a remote object, initialized with the specified remote reference.
 
Method Summary
 boolean equals(Object obj)
          Compares two remote objects for equality.
 RemoteRef getRef()
          Returns the remote reference for the remote object.
 int hashCode()
          Returns a hashcode for a remote object.
 String toString()
          Returns a String that represents the value of this remote object.
static Remote toStub(Remote obj)
          Returns the stub for the remote object obj passed as a parameter.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

ref

protected transient RemoteRef ref
the objects remote reference
Constructor Detail

RemoteObject

protected RemoteObject()
Creates a remote object.
Since:
JDK1.1

RemoteObject

protected RemoteObject(RemoteRef newref)
Creates a remote object, initialized with the specified remote reference.
Since:
JDK1.1
Method Detail

getRef

public RemoteRef getRef()
Returns the remote reference for the remote object.
Since:
JDK1.2

toStub

public static Remote toStub(Remote obj)
                     throws NoSuchObjectException
Returns the stub for the remote object obj passed as a parameter. This operation is only valid after the object has been exported.
Parameters:
obj - the remote object whose stub is neede
Returns:
the stub for the remote object, obj.
Throws:
NoSuchObjectException - if the stub for the remote object could not be found.
Since:
JDK1.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).
Overrides:
hashCode in class Object
Since:
JDK1.1
See Also:
Hashtable

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 the equals method of its parameter with this remote object as the argument.
Parameters:
obj - the Object to compare with
Returns:
true if these Objects are equal; false otherwise.
Overrides:
equals in class Object
Since:
JDK1.1
See Also:
Hashtable

toString

public String toString()
Returns a String that represents the value of this remote object.
Overrides:
toString in class Object
Since:
JDK1.1

Java Platform 1.2

Submit a bug or feature Version 1.2 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.