モジュール java.xml.ws
パッケージ javax.xml.soap

クラスSOAPException

  • すべての実装されたインタフェース:
    Serializable
    public class SOAPException
extends Exception
    SOAP例外が発生したことを通知する例外です。 SOAPExceptionオブジェクトには、例外の理由を示すString、組み込みThrowableオブジェクト、あるいはその両方が含まれる場合があります。 このクラスは、理由メッセージの取得および組み込みThrowableオブジェクトの取得のためのメソッドを提供します。

    SOAPExceptionオブジェクトがスローされる一般的な理由は、ヘッダーの設定が困難である、メッセージを送信できない、およびプロバイダとの接続を取得できないなどの問題です。 Throwableオブジェクトの組込みに関する理由には、入出力エラーなどの問題、またはヘッダーの構文解析時のエラーなどの解析関連の問題が含まれます。

    導入されたバージョン:
    1.6
    関連項目:
    直列化された形式

    • コンストラクタの詳細

      • SOAPException

        public SOAPException()
        理由なしSOAPExceptionオブジェクトまたは組み込みThrowableオブジェクトを構築します。

      • SOAPException

        public SOAPException​(String reason)
        スローされる例外の理由として、指定されたStringを使用して、SOAPExceptionオブジェクトを構築します。
        パラメータ:
        reason - 例外の発生原因の説明

      • SOAPException

        public SOAPException​(String reason,
                     Throwable cause)
        スローされる例外の理由として、指定されたStringを使用し、また組込み例外として、指定されたThrowableオブジェクトを使用して、SOAPExceptionオブジェクトを構築します。
        パラメータ:
        reason - 例外の発生原因の説明
        cause - このSOAPExceptionオブジェクトに組み込まれるThrowableオブジェクト

      • SOAPException

        public SOAPException​(Throwable cause)
        指定されたThrowableオブジェクトで初期化されたSOAPExceptionオブジェクトを構築します。
        パラメータ:
        cause - このSOAPExceptionオブジェクトに組み込まれるThrowableオブジェクト

    • メソッドの詳細

      • getMessage

        public String getMessage()
        このSOAPExceptionオブジェクトの詳細メッセージを返します。

        組み込みThrowableオブジェクトが存在し、SOAPExceptionオブジェクトが固有の詳細メッセージを持たない場合、このメソッドは組み込みThrowableオブジェクトの詳細メッセージを返します。

        オーバーライド:
        getMessage、クラス: Throwable
        戻り値:
        このSOAPExceptionのエラー・メッセージまたは警告メッセージ。それらがない場合は、組み込みThrowableオブジェクトのメッセージ(存在する場合)

      • getCause

        public Throwable getCause()
        このSOAPExceptionに組みこまれたThrowableオブジェクトを返します(存在する場合)。 それ以外の場合、このメソッドはnullを返します。
        オーバーライド:
        getCause、クラス: Throwable
        戻り値:
        組み込みThrowableオブジェクト。ない場合はnull

      • initCause

        public Throwable initCause​(Throwable cause)
        このSOAPExceptionオブジェクトのcauseフィールドを、指定したThrowableオブジェクトで初期化します。

        このメソッドは最大で1回しか呼び出すことができません。 通常は、コンストラクタ内から、またはコンストラクタが新しいSOAPExceptionオブジェクトを返した直後に呼び出されます。 このSOAPExceptionオブジェクトがコンストラクタSOAPException(Throwable)またはSOAPException(String,Throwable)を使用して作成された場合、つまりそのcauseフィールドにすでに値が存在する場合、このメソッドは1回も呼び出すことができません。

        オーバーライド:
        initCause、クラス: Throwable
        パラメータ:
        cause - このSOAPExceptionオブジェクトがスローされる原因となったThrowableオブジェクト。 このパラメータの値は、あとでgetCause()メソッドで取得するために保存される。 null値が許可されており、原因が存在しないか不明であることを示す。
        戻り値:
        このSOAPExceptionインスタンスへの参照
        例外:
        IllegalArgumentException - causeがこのThrowableオブジェクトの場合。 (Throwableオブジェクトはそれ自身の原因にはなれない。)
        IllegalStateException - このSOAPExceptionオブジェクトの原因がすでに初期化されている場合