Save This Page
Home » openjdk-7 » java » rmi » [javadoc | source]
java.rmi
public class: RemoteException [javadoc | source]
java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         java.io.IOException
            java.rmi.RemoteException

All Implemented Interfaces:
    Serializable

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 #detail field is now known as the cause, and may be accessed via the Throwable#getCause() method, as well as the aforementioned "legacy field."

Invoking the method Throwable#initCause(Throwable) on an instance of RemoteException always throws IllegalStateException .

Field Summary
public  Throwable detail    The cause of the remote exception.

This field predates the general-purpose exception chaining facility. The Throwable#getCause() method is now the preferred means of obtaining this information.

    serial:
 
Fields inherited from java.io.IOException:
serialVersionUID
Fields inherited from java.lang.Exception:
serialVersionUID
Constructor:
 public RemoteException() 
 public RemoteException(String s) 
    Constructs a RemoteException with the specified detail message.
    Parameters:
    s - the detail message
 public RemoteException(String s,
    Throwable cause) 
    Constructs a RemoteException with the specified detail message and cause. This constructor sets the #detail field to the specified Throwable.
    Parameters:
    s - the detail message
    cause - the cause
Method from java.rmi.RemoteException Summary:
getCause,   getMessage
Methods from java.lang.Throwable:
addSuppressed,   fillInStackTrace,   getCause,   getLocalizedMessage,   getMessage,   getStackTrace,   getStackTraceDepth,   getStackTraceElement,   getSuppressed,   initCause,   printStackTrace,   printStackTrace,   printStackTrace,   setStackTrace,   toString
Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from java.rmi.RemoteException Detail:
 public Throwable getCause() 
    Returns the cause of this exception. This method returns the value of the #detail field.
 public String getMessage() 
    Returns the detail message, including the message from the cause, if any, of this exception.