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 オブジェクトの原因が 既に初期化されている場合