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() 理由なしSOAPExceptionオブジェクトまたは組み込みThrowableオブジェクトを構築します。
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から継承されたメソッド

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

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

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

コンストラクタの詳細

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

メソッドの詳細

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