Class RemoteException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.io.IOException
java.rmi.RemoteException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
AccessException, ConnectException, ConnectIOException, ExportException, MarshalException, NoSuchObjectException, ServerError, ServerException, ServerRuntimeException, SkeletonMismatchException, SkeletonNotFoundException, StubNotFoundException, UnexpectedException, UnknownHostException, UnmarshalException
public class RemoteException extends IOException
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.

Since:
1.1
See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    Throwable
    detail
    The cause of the remote exception.

  • Constructor Summary

    Constructors
    Constructor
    Description
    RemoteException()
    Constructs a RemoteException.
    RemoteException(String s)
    Constructs a RemoteException with the specified detail message.
    RemoteException(String s, Throwable cause)
    Constructs a RemoteException with the specified detail message and cause.

  • Method Summary

    Modifier and Type
    Method
    Description
    Throwable
    getCause()
    Returns the cause of this exception.
    String
    getMessage()
    Returns the detail message, including the message from the cause, if any, of this exception.

    Methods declared in class Throwable

    addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
    Modifier and Type
    Method
    Description
    final void
    addSuppressed(Throwable exception)
    The specified exception is going to be suppressed in order to give priority to this exception (primary exception) and to be appended to the list of suppressed exceptions.
    Throwable
    fillInStackTrace()
    Record in the receiver a walkback from the point where this message was sent.
    String
    getLocalizedMessage()
    Answers the extra information message which was provided when the throwable was created.
    StackTraceElement[]
    getStackTrace()
    Answers an array of StackTraceElement.
    final Throwable[]
    getSuppressed()
    Returns an array of exceptions suppressed, typically by the automatically generated code from the try-with-resources statement, in order to give priority to this exception (primary exception).
    Throwable
    initCause(Throwable throwable)
    Initialize the cause of the receiver.
    void
    printStackTrace()
    Outputs a printable representation of the receiver's walkback on the System.err stream.
    void
    printStackTrace(PrintStream err)
    Outputs a printable representation of the receiver's walkback on the stream specified by the argument.
    void
    printStackTrace(PrintWriter err)
    Outputs a printable representation of the receiver's walkback on the writer specified by the argument.
    void
    setStackTrace(StackTraceElement[] trace)
    Sets the array of StackTraceElements.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Field Details

    • detail

      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.

  • Constructor Details

    • RemoteException

      public RemoteException()
      Constructs a RemoteException.

    • RemoteException

      public RemoteException(String s)
      Constructs a RemoteException with the specified detail message.
      Parameters:
      s - the detail message

    • RemoteException

      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 Details

    • getMessage

      public String getMessage()
      Returns the detail message, including the message from the cause, if any, of this exception.
      Overrides:
      getMessage in class Throwable
      Returns:
      the detail message

    • getCause

      public Throwable getCause()
      Returns the cause of this exception. This method returns the value of the detail field.
      Overrides:
      getCause in class Throwable
      Returns:
      the cause, which may be null.
      Since:
      1.4