javax.xml.soap
クラス SOAPException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.xml.soap.SOAPException

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

Serializable

public class SOAPException
extends Exception

SOAP 例外が発生したことを通知する例外です。SOAPException オブジェクトには、例外の理由を示す String、組み込み Throwable オブジェクト、あるいはその両方が含まれる場合があります。このクラスは、理由メッセージの取得および組み込み Throwable オブジェクトの取得のためのメソッドを提供します。

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

関連項目:

直列化された形式

コンストラクタの概要

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

SOAPException(String reason)
スローされる例外の理由として、指定された String を使用して、SOAPException オブジェクトを構築します。

SOAPException(String reason, Throwable cause)
スローされる例外の理由として、指定された String を使用し、また組み込み例外として、指定された Throwable オブジェクトを使用して、SOAPException オブジェクトを構築します。

SOAPException(Throwable cause)
指定された Throwable オブジェクトで初期化された SOAPException オブジェクトを構築します。

メソッドの概要

Throwable	getCause() この SOAPException に組みこまれた Throwable オブジェクトを返します (存在する場合)。
String	getMessage() SOAPException の詳細メッセージを返します。
Throwable	initCause(Throwable cause) この SOAPException オブジェクトの cause フィールドを、指定した Throwable オブジェクトで初期化します。

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

fillInStackTrace, getLocalizedMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

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

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

コンストラクタの詳細

SOAPException

public SOAPException()

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

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 オブジェクトを構築します。

メソッドの詳細

getMessage

public String getMessage()

SOAPException の詳細メッセージを返します。

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

オーバーライド:

クラス Throwable 内の getMessage

戻り値:

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

getCause

public Throwable getCause()

この SOAPException に組みこまれた Throwable オブジェクトを返します (存在する場合)。そうでない場合は、このメソッドは null を返します。

オーバーライド:

クラス Throwable 内の getCause

戻り値:

組み込み Throwable オブジェクト。存在しない場合は null

initCause

public Throwable initCause(Throwable cause)

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

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

オーバーライド:

クラス Throwable 内の initCause

パラメータ:

cause - この SOAPException オブジェクトがスローされる原因となった Throwable オブジェクト。このパラメータの値は、あとで getCause() メソッドで取得するために保存される。null 値が許可されており、原因が存在しないか不明であることを示す

戻り値:

この SOAPException インスタンスへの参照

例外:

IllegalArgumentException - cause がこの Throwable オブジェクトである場合 (Throwable オブジェクトはそれ自身の原因にはなれない)

IllegalStateException - この SOAPException オブジェクトの原因がすでに初期化されている場合