A
RemoteException
is the common superclass for a number of communication-related exceptions that may occur during the execution of a remote method call. Each method of a remote interface, an interface that extends
java.rmi.Remote
, must list
RemoteException
in its throws clause.
As of release 1.4, this exception has been retrofitted to conform to the general purpose exception-chaining mechanism. The "wrapped remote exception" that may be provided at construction time and accessed via the public {@link #detail} field is now known as the cause, andmay be accessed via the {@link Throwable#getCause()} method, as well asthe aforementioned "legacy field."
Invoking the method {@link Throwable#initCause(Throwable)} on aninstance of RemoteException
always throws {@link IllegalStateException}.
@version 1.25, 11/17/05
@author Ann Wollrath
@since JDK1.1