パッケージ jakarta.xml.soap

クラス SOAPException

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

    SOAPException オブジェクトをスローする一般的な理由は、ヘッダーの設定が難しい、メッセージを送信できない、プロバイダーとの接続を取得できないなどの問題です。Throwable オブジェクトを埋め込む理由には、入出力エラーなどの問題や、ヘッダーの解析エラーなどの解析問題が含まれます。

    導入:
    1.6
    関連事項:
    連載形式

    • コンストラクターの詳細

      • SOAPException

        public SOAPException()
        理由のない SOAPException オブジェクトまたは埋め込まれた Throwable オブジェクトを構築します。

      • SOAPException

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

      • SOAPException

        public SOAPException​(StringSE reason,
                     ThrowableSE cause)
        指定された String を例外がスローされる理由として、指定された Throwable オブジェクトを埋め込み例外として、SOAPException オブジェクトを作成します。
        パラメーター:
        reason - 例外の原因の説明
        cause - この SOAPException オブジェクトに埋め込まれる Throwable オブジェクト

      • SOAPException

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

    • メソッドの詳細

      • getMessage

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

        埋め込まれた Throwable オブジェクトがあり、SOAPException オブジェクトに独自の詳細メッセージがない場合、このメソッドは埋め込まれた Throwable オブジェクトから詳細メッセージを返します。

        オーバーライド:
        クラス ThrowableSE の getMessage 
        戻り値:
        この SOAPException のエラーまたは警告メッセージ、または存在しない場合は、埋め込まれた Throwable オブジェクトのメッセージ（存在する場合）

      • getCause

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

      • initCause

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

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

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