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
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
-
Constructor Summary
ConstructorDescriptionConstructs aRemoteException
.Constructs aRemoteException
with the specified detail message.RemoteException
(String s, Throwable cause) Constructs aRemoteException
with the specified detail message and cause. -
Method Summary
Modifier and TypeMethodDescriptiongetCause()
Returns the cause of this exception.Returns the detail message, including the message from the cause, if any, of this exception.Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Field Details
-
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 aRemoteException
. -
RemoteException
Constructs aRemoteException
with the specified detail message.- Parameters:
s
- the detail message
-
RemoteException
-
-
Method Details
-
getMessage
Returns the detail message, including the message from the cause, if any, of this exception.- Overrides:
getMessage
in classThrowable
- Returns:
- the detail message
-
getCause
-