java.rmi: public class: RemoteException

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 .

author: Ann - Wollrath

since: JDK1.1 -

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:

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:

Constructor:
public RemoteException() { initCause(null); // Disallow subsequent initCause } Constructs a `RemoteException`.
public RemoteException(String s) { super(s); initCause(null); // Disallow subsequent initCause } Constructs a `RemoteException` with the specified detail message. Parameters: `s` - the detail message
public RemoteException(String s, Throwable cause) { super(s); initCause(null); // Disallow subsequent initCause detail = 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

 public RemoteException() {
        initCause(null);  // Disallow subsequent initCause
}

Constructs a RemoteException.

 public RemoteException(String s) {
        super(s);
        initCause(null);  // Disallow subsequent initCause
}

RemoteException

Parameters:

s - the detail message

 public RemoteException(String s,
    Throwable cause) {
        super(s);
        initCause(null);  // Disallow subsequent initCause
        detail = cause;
}

RemoteException

#detail

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() { return detail; } Returns the cause of this exception. This method returns the value of the #detail field.
public String getMessage() { if (detail == null) { return super.getMessage(); } else { return super.getMessage() + "; nested exception is: \n\t" + detail.toString(); } } Returns the detail message, including the message from the cause, if any, of this exception.

Method from java.rmi.RemoteException Detail:

 public Throwable getCause() {
        return detail;
}

#detail

 public String getMessage() {
        if (detail == null) {
            return super.getMessage();
        } else {
            return super.getMessage() + "; nested exception is: \n\t" +
                detail.toString();
        }
}

Returns the detail message, including the message from the cause, if any, of this exception.