クラスRemoteException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.io.IOException
java.rmi.RemoteException
すべての実装されたインタフェース:
Serializable
直系の既知のサブクラス:
AccessException, ConnectException, ConnectIOException, ExportException, MarshalException, NoSuchObjectException, ServerError, ServerException, ServerRuntimeException, SkeletonMismatchException, SkeletonNotFoundException, StubNotFoundException, 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()
    この例外の詳細メッセージ(原因のメッセージがある場合はそれも含む)を返します。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    Throwable
    initCause(Throwable cause)
    このスロー可能オブジェクトの原因を、指定された値に初期化します。
    void
    printStackTrace()
    このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
    void
    printStackTrace(PrintStream s)
    このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
    void
    printStackTrace(PrintWriter s)
    このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。
    String
    toString()
    このスロー可能オブジェクトの短い記述を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • 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