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 classRemoteExceptionextendsIOException
ARemoteException 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 extendsjava.rmi.Remote, must listRemoteException 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 publicdetail field is now known as thecause, and may be accessed via theThrowable.getCause() method, as well as the aforementioned "legacy field."

Invoking the methodThrowable.initCause(Throwable) on an instance ofRemoteException always throwsIllegalStateException.

Since:
1.1
See Also:

  • Field Details

    • detail

      public Throwable detail
      The cause of the remote exception.

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

  • Constructor Details

    • RemoteException

      public RemoteException()
      Constructs aRemoteException.

    • RemoteException

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

    • RemoteException

      public RemoteException(String s,Throwable cause)
      Constructs aRemoteException with the specified detail message and cause. This constructor sets thedetail field to the specifiedThrowable.
      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 thedetail field.
      Overrides:
      getCause in class Throwable
      Returns:
      the cause, which may benull.
      Since:
      1.4