java.rmi
Class RemoteException

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.lang.Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable 
      extended by java.lang.Exception sample code for java.lang.Exception definition code for java.lang.Exception 
          extended by java.io.IOException sample code for java.io.IOException definition code for java.io.IOException 
              extended by java.rmi.RemoteException
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable
Direct Known Subclasses:
AccessException sample code for java.rmi.AccessException definition code for java.rmi.AccessException , ActivateFailedException sample code for java.rmi.activation.ActivateFailedException definition code for java.rmi.activation.ActivateFailedException , ConnectException sample code for java.rmi.ConnectException definition code for java.rmi.ConnectException , ConnectIOException sample code for java.rmi.ConnectIOException definition code for java.rmi.ConnectIOException , ExportException sample code for java.rmi.server.ExportException definition code for java.rmi.server.ExportException , MarshalException sample code for java.rmi.MarshalException definition code for java.rmi.MarshalException , NoSuchObjectException sample code for java.rmi.NoSuchObjectException definition code for java.rmi.NoSuchObjectException , ServerError sample code for java.rmi.ServerError definition code for java.rmi.ServerError , ServerException sample code for java.rmi.ServerException definition code for java.rmi.ServerException , ServerRuntimeException sample code for java.rmi.ServerRuntimeException definition code for java.rmi.ServerRuntimeException , SkeletonMismatchException sample code for java.rmi.server.SkeletonMismatchException definition code for java.rmi.server.SkeletonMismatchException , SkeletonNotFoundException sample code for java.rmi.server.SkeletonNotFoundException definition code for java.rmi.server.SkeletonNotFoundException , StubNotFoundException sample code for java.rmi.StubNotFoundException definition code for java.rmi.StubNotFoundException , UnexpectedException sample code for java.rmi.UnexpectedException definition code for java.rmi.UnexpectedException , UnknownHostException sample code for java.rmi.UnknownHostException definition code for java.rmi.UnknownHostException , UnmarshalException sample code for java.rmi.UnmarshalException definition code for java.rmi.UnmarshalException

public class RemoteException
extends IOException sample code for java.io.IOException definition code for java.io.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 sample code for java.rmi.RemoteException.detail definition code for java.rmi.RemoteException.detail field is now known as the cause, and may be accessed via the Throwable.getCause() sample code for java.lang.Throwable.getCause() definition code for java.lang.Throwable.getCause() method, as well as the aforementioned "legacy field."

Invoking the method Throwable.initCause(Throwable) sample code for java.lang.Throwable.initCause(java.lang.Throwable) definition code for java.lang.Throwable.initCause(java.lang.Throwable) on an instance of RemoteException always throws IllegalStateException sample code for java.lang.IllegalStateException definition code for java.lang.IllegalStateException .

Since:
JDK1.1
See Also:
Serialized Form

Field Summary
 Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable detail sample code for java.rmi.RemoteException.detail definition code for java.rmi.RemoteException.detail
          The cause of the remote exception.
 
Constructor Summary
RemoteException sample code for java.rmi.RemoteException.RemoteException() definition code for java.rmi.RemoteException.RemoteException() ()
          Constructs a RemoteException.
RemoteException sample code for java.rmi.RemoteException.RemoteException(java.lang.String) definition code for java.rmi.RemoteException.RemoteException(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  s)
          Constructs a RemoteException with the specified detail message.
RemoteException sample code for java.rmi.RemoteException.RemoteException(java.lang.String, java.lang.Throwable) definition code for java.rmi.RemoteException.RemoteException(java.lang.String, java.lang.Throwable) (String sample code for java.lang.String definition code for java.lang.String  s, Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  cause)
          Constructs a RemoteException with the specified detail message and cause.
 
Method Summary
 Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable getCause sample code for java.rmi.RemoteException.getCause() definition code for java.rmi.RemoteException.getCause() ()
          Returns the cause of this exception.
 String sample code for java.lang.String definition code for java.lang.String getMessage sample code for java.rmi.RemoteException.getMessage() definition code for java.rmi.RemoteException.getMessage() ()
          Returns the detail message, including the message from the cause, if any, of this exception.
 
Methods inherited from class java.lang.Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable
fillInStackTrace sample code for java.lang.Throwable.fillInStackTrace() definition code for java.lang.Throwable.fillInStackTrace() , getLocalizedMessage sample code for java.lang.Throwable.getLocalizedMessage() definition code for java.lang.Throwable.getLocalizedMessage() , getStackTrace sample code for java.lang.Throwable.getStackTrace() definition code for java.lang.Throwable.getStackTrace() , initCause sample code for java.lang.Throwable.initCause(java.lang.Throwable) definition code for java.lang.Throwable.initCause(java.lang.Throwable) , printStackTrace sample code for java.lang.Throwable.printStackTrace() definition code for java.lang.Throwable.printStackTrace() , printStackTrace sample code for java.lang.Throwable.printStackTrace(java.io.PrintStream) definition code for java.lang.Throwable.printStackTrace(java.io.PrintStream) , printStackTrace sample code for java.lang.Throwable.printStackTrace(java.io.PrintWriter) definition code for java.lang.Throwable.printStackTrace(java.io.PrintWriter) , setStackTrace sample code for java.lang.Throwable.setStackTrace(java.lang.StackTraceElement[]) definition code for java.lang.Throwable.setStackTrace(java.lang.StackTraceElement[]) , toString sample code for java.lang.Throwable.toString() definition code for java.lang.Throwable.toString()
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , hashCode sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Field Detail

detail sample code for java.rmi.RemoteException.detail

public Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  detail
The cause of the remote exception.

This field predates the general-purpose exception chaining facility. The Throwable.getCause() sample code for java.lang.Throwable.getCause() definition code for java.lang.Throwable.getCause() method is now the preferred means of obtaining this information.

Constructor Detail

RemoteException sample code for java.rmi.RemoteException() definition code for java.rmi.RemoteException()

public RemoteException()
Constructs a RemoteException.


RemoteException sample code for java.rmi.RemoteException(java.lang.String) definition code for java.rmi.RemoteException(java.lang.String)

public RemoteException(String sample code for java.lang.String definition code for java.lang.String  s)
Constructs a RemoteException with the specified detail message.

Parameters:
s - the detail message

RemoteException sample code for java.rmi.RemoteException(java.lang.String, java.lang.Throwable) definition code for java.rmi.RemoteException(java.lang.String, java.lang.Throwable)

public RemoteException(String sample code for java.lang.String definition code for java.lang.String  s,
                       Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  cause)
Constructs a RemoteException with the specified detail message and cause. This constructor sets the detail sample code for java.rmi.RemoteException.detail definition code for java.rmi.RemoteException.detail field to the specified Throwable.

Parameters:
s - the detail message
cause - the cause
Method Detail

getMessage sample code for java.rmi.RemoteException.getMessage() definition code for java.rmi.RemoteException.getMessage()

public String sample code for java.lang.String definition code for java.lang.String  getMessage()
Returns the detail message, including the message from the cause, if any, of this exception.

Overrides:
getMessage sample code for java.lang.Throwable.getMessage() definition code for java.lang.Throwable.getMessage() in class Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable
Returns:
the detail message

getCause sample code for java.rmi.RemoteException.getCause() definition code for java.rmi.RemoteException.getCause()

public Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  getCause()
Returns the cause of this exception. This method returns the value of the detail sample code for java.rmi.RemoteException.detail definition code for java.rmi.RemoteException.detail field.

Overrides:
getCause sample code for java.lang.Throwable.getCause() definition code for java.lang.Throwable.getCause() in class Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable
Returns:
the cause, which may be null.
Since:
1.4