モジュール java.rmi

パッケージ java.rmi

クラスRemoteException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

java.rmi.RemoteException

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

AccessException, ActivateFailedException, ActivityCompletedException, ActivityRequiredException, ConnectException, ConnectIOException, ExportException, InvalidActivityException, InvalidTransactionException, MarshalException, NoSuchObjectException, ServerError, ServerException, ServerRuntimeException, SkeletonMismatchException, SkeletonNotFoundException, StubNotFoundException, TransactionRequiredException, TransactionRolledbackException, UnexpectedException, UnknownHostException, UnmarshalException

public class RemoteException
extends IOException

RemoteExceptionは、リモート・メソッド呼出しの実行中に発生する可能性のあるいくつかの通信関連の例外で使用する共通のスーパー・クラスです。 java.rmi.Remoteを拡張するインタフェースであるリモート・インタフェースの各メソッドは、そのthrows節にRemoteExceptionを記載する必要があります。

1.4リリースでは、この例外は汎用的な例外チェーン・メカニズムに適合するように改良されています。 構築時に提供され、public detailフィールドを介してアクセスされる「ラップされたリモート例外」は、原因と呼ばれるようになり、前述の「レガシー・フィールド」だけでなく、Throwable.getCause()メソッドを介してもアクセスできます。

RemoteExceptionのインスタンス上でThrowable.initCause(Throwable)メソッドを呼び出した場合、常にIllegalStateExceptionがスローされます。

導入されたバージョン:

1.1

関連項目:

直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
Throwable	detail	このリモート例外の原因です。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
RemoteException()	RemoteExceptionを構築します。
RemoteException(String s)	指定された詳細メッセージを持つRemoteExceptionを構築します。
RemoteException(String s, Throwable cause)	指定された詳細メッセージと原因を持つRemoteExceptionを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
Throwable	getCause()	この例外の原因を返します。
String	getMessage()	この例外の詳細メッセージ(原因のメッセージがある場合はそれも含む)を返します。

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

クラス java.lang.Throwableから継承されたメソッド

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

フィールドの詳細

detail

public Throwable detail

このリモート例外の原因です。

このフィールドは、汎用的な例外チェーン機能以前から使用されています。 Throwable.getCause()メソッドが、この情報を取得するために現在推奨されている手段です。

コンストラクタの詳細

RemoteException

public RemoteException()

RemoteExceptionを構築します。

RemoteException

public RemoteException(String s)

指定された詳細メッセージを持つRemoteExceptionを構築します。

パラメータ:

s - 詳細メッセージ

RemoteException

public RemoteException(String s,
                       Throwable cause)

指定された詳細メッセージと原因を持つRemoteExceptionを構築します。 このコンストラクタは、detailフィールドに、指定されたThrowableを設定します。

パラメータ:

s - 詳細メッセージ

cause - 原因

メソッドの詳細

getMessage

public String getMessage()

この例外の詳細メッセージ(原因のメッセージがある場合はそれも含む)を返します。

オーバーライド:

getMessage、クラス: Throwable

戻り値:

詳細メッセージ

getCause

public Throwable getCause()

この例外の原因を返します。 このメソッドが返すのはdetailフィールドの値です。

オーバーライド:

getCause、クラス: Throwable

戻り値:

原因。nullの場合もある

導入されたバージョン:

1.4