OpenJDK 1.23 · java.rmi.RemoteException · APIdia, the JavaDoc alternative

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.

Field Summary

Modifier and Type	Field and Description
public Throwable	detail The cause of the remote exception.
private static final long	serialVersionUID Hides java.io.IOException.serialVersionUID.

Constructor Summary

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

Method Summary

Modifier and Type	Method and Description
public Throwable	Returns: the cause, which may be `null`. getCause() Overrides java.lang.Throwable.getCause. Returns the cause of this exception.
public String	Returns: the detail message getMessage() Overrides java.lang.Throwable.getMessage. Returns the detail message, including the message from the cause, if any, of this exception.

Field Detail

detail back to summary

detail	back to 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.

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.

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.io.IOException.serialVersionUID.

Constructor Detail

RemoteException	back to summary
public RemoteException() Constructs a `RemoteException`.

RemoteException back to summary

RemoteException	back to summary
public RemoteException(String s) Constructs a `RemoteException` with the specified detail message. Parameters s:String the detail message

public RemoteException(String s)

Constructs a RemoteException with the specified detail message.

Parameters

s:String: the detail message

RemoteException back to summary

RemoteException	back to summary
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:String the detail message cause:Throwable the cause

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:String: the detail message
cause:Throwable: the cause

Method Detail

getCause back to summary

getCause	back to summary
public Throwable getCause() Overrides java.lang.Throwable.getCause. Returns the cause of this exception. This method returns the value of the `detail` field. Returns:Throwable the cause, which may be `null`. Since 1.4

public Throwable getCause()

Overrides java.lang.Throwable.getCause.

Returns the cause of this exception. This method returns the value of the detail field.

Returns:Throwable: the cause, which may be null.
Since: 1.4

getMessage	back to summary
public String getMessage() Overrides java.lang.Throwable.getMessage. Returns the detail message, including the message from the cause, if any, of this exception. Returns:String the detail message

getMessage

back to summary

public String getMessage()

Overrides java.lang.Throwable.getMessage.

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