UnicastRemoteObject

Class Overview

Used for exporting a remote object with JRMP and obtaining a stub that communicates to the remote object.

For the constructors and static exportObject methods below, the stub for a remote object being exported is obtained as follows:

• If the remote object is exported using the UnicastRemoteObject.exportObject(Remote) method, a stub class (typically pregenerated from the remote object's class using the rmic tool) is loaded and an instance of that stub class is constructed as follows.
  • A "root class" is determined as follows: if the remote object's class directly implements an interface that extends Remote, then the remote object's class is the root class; otherwise, the root class is the most derived superclass of the remote object's class that directly implements an interface that extends Remote.
  • The name of the stub class to load is determined by concatenating the binary name of the root class with the suffix "_Stub".
  • The stub class is loaded by name using the class loader of the root class. The stub class must extend RemoteStub and must have a public constructor that has one parameter, of type RemoteRef.
  • Finally, an instance of the stub class is constructed with a RemoteRef.
• If the appropriate stub class could not be found, or the stub class could not be loaded, or a problem occurs creating the stub instance, a StubNotFoundException is thrown.

• For all other means of exporting:
  • If the remote object's stub class (as defined above) could not be loaded or the system property java.rmi.server.ignoreStubClasses is set to "true" (case insensitive), a Proxy instance is constructed with the following properties:
    • The proxy's class is defined by the class loader of the remote object's class.
    • The proxy implements all the remote interfaces implemented by the remote object's class.
    • The proxy's invocation handler is a RemoteObjectInvocationHandler instance constructed with a RemoteRef.
    • If the proxy could not be created, a StubNotFoundException will be thrown.

  • Otherwise, an instance of the remote object's stub class (as described above) is used as the stub.

Summary

[Expand] Inherited Fields
From class java.rmi.server.RemoteObject protected RemoteRef ref The object's remote reference.

[Expand] Inherited Methods
From class java.rmi.server.RemoteServer static String getClientHost() Returns a string representation of the client host for the remote method invocation being processed in the current thread. static PrintStream getLog() Returns stream for the RMI call log. static void setLog(OutputStream out) Log RMI calls to the output stream out.
From class java.rmi.server.RemoteObject 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.
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait() Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object. final void wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed. final void wait(long timeout) Causes the current thread to wait until either another thread invokes the notify() method or the notifyAll() method for this object, or a specified amount of time has elapsed.