Java Enterprise in a Nutshell, Second Edition

Name

RemoteRef

Synopsis

A handle on the object implementing a remote object reference. Each RemoteObject contains a RemoteRef which acts as its interface to the actual remote object it represents. Normally, you won’t need to interact directly with RemoteRefs from your application code. Rather, application code will interact with RemoteObjects, which use their internal RemoteRefs to perform remote method invocations.

The newCall() method is used to create a call object for invoking a remote method on the referenced object. The invoke() method actually executes a remote method invocation. If a remote method returns successfully, then the done() method is called to clean up the connection to the remote object.

The remoteEquals(), remoteHashCode() and remoteToString() methods on RemoteRef are used by RemoteObjects to implement the remote versions of the equals(), hashCode() and toString() methods.

                  
public interface RemoteRef extends Externalizable {
// Public Constants
   public static final String packagePrefix;                     // ="sun.rmi.server”
   public static final long serialVersionUID;                    // =3632638527362204081, 1.2
                  // Public Instance Methods
   public abstract String getRefClass( ObjectOutput out);  
   public abstract Object invoke(Remote obj,                     // 1.2
        java.lang.reflect.Method method, 
        Object[] params, 
        long opnum) throws Exception;  
   public abstract boolean remoteEquals( RemoteRef obj);  
   public abstract int remoteHashCode ...