javax.xml.transform

クラス TransformerException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.xml.transform.TransformerException

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

Serializable

直系の既知のサブクラス:

TransformerConfigurationException

public class TransformerException
extends Exception

このクラスは、変換処理中に発生した例外状態を示します。

関連項目:

直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
TransformerException(String message) 新しい TransformerException を作成します。
TransformerException(String message, SourceLocator locator) メッセージとロケータから新しい TransformerException を作成します。
TransformerException(String message, SourceLocator locator, Throwable e) 既存の例外を TransformerException にラップします。
TransformerException(String message, Throwable e) 既存の例外を TransformerException にラップします。
TransformerException(Throwable e) 既存の例外をラップする新しい TransformerException を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Throwable	getCause() このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合は null を返します。
Throwable	getException() このメソッドは、この例外がラップする例外を取得します。
String	getLocationAsString() 位置情報を文字列として取得します。
SourceLocator	getLocator() getLocator メソッドは、エラーが発生した場所を示す SourceLocator オブジェクトのインスタンスを取得します。
String	getMessageAndLocation() 位置情報が追加されたエラーメッセージを取得します。
Throwable	initCause(Throwable cause) このスロー可能オブジェクトの原因を、指定された値に初期化します。
void	printStackTrace() エラーが発生した元の場所からのメソッドのトレースを出力します。
void	printStackTrace(PrintStream s) エラーが発生した元の場所からのメソッドのトレースを出力します。
void	printStackTrace(PrintWriter s) エラーが発生した元の場所からのメソッドのトレースを出力します。
void	setLocator(SourceLocator location) setLocator メソッドは、エラーが発生した場所を示す SourceLocator オブジェクトのインスタンスを設定します。

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

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

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

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

コンストラクタの詳細

TransformerException

public TransformerException(String message)

新しい TransformerException を作成します。

パラメータ:

message - エラーまたは警告メッセージ。

TransformerException

public TransformerException(Throwable e)

既存の例外をラップする新しい TransformerException を作成します。

パラメータ:

e- ラップされる例外。

TransformerException

public TransformerException(String message,
                    Throwable e)

既存の例外を TransformerException にラップします。

これは、処理を開始する前にプロセッサ例外をスローするために使用されます。

パラメータ:

message - エラーメッセージ、警告メッセージ、または null。null の場合は組み込み例外のメッセージを利用する。

e - 任意の例外

TransformerException

public TransformerException(String message,
                    SourceLocator locator)

メッセージとロケータから新しい TransformerException を作成します。

このコンストラクタは、アプリケーションが DocumentHandler コールバック内から独自の例外を作成するときに特に役に立ちます。

パラメータ:

message - エラーまたは警告メッセージ。

locator - エラーまたは警告のロケータオブジェクト。

TransformerException

public TransformerException(String message,
                    SourceLocator locator,
                    Throwable e)

既存の例外を TransformerException にラップします。

パラメータ:

message - エラーメッセージ、警告メッセージ、または null。null の場合は組み込み例外のメッセージを利用する。

locator - エラーまたは警告のロケータオブジェクト。

e - 任意の例外

メソッドの詳細

getLocator

public SourceLocator getLocator()

getLocator メソッドは、エラーが発生した場所を示す SourceLocator オブジェクトのインスタンスを取得します。

戻り値:

SourceLocator オブジェクト。何も指定されなかった場合は null。

setLocator

public void setLocator(SourceLocator location)

setLocator メソッドは、エラーが発生した場所を示す SourceLocator オブジェクトのインスタンスを設定します。

パラメータ:

location - SourceLocator オブジェクト。場所をクリアーする場合は null。

getException

public Throwable getException()

このメソッドは、この例外がラップする例外を取得します。

戻り値:

Throwable オブジェクト、または null。

関連項目:

getCause()

getCause

public Throwable getCause()

このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合は null を返します。原因はこの Throwable をスローさせた Throwable です。

オーバーライド:

getCause、クラス: Throwable

戻り値:

このスロー可能オブジェクトの原因。原因が存在しないか不明の場合は null。

initCause

public Throwable initCause(Throwable cause)

このスロー可能オブジェクトの原因を、指定された値に初期化します。原因はこの Throwable をスローさせた Throwable です。

このメソッドは最大で 1 回しか呼び出すことができません。通常は、コンストラクタ内から、または Throwable の作成直後に呼び出されます。このスロー可能オブジェクトが TransformerException(Throwable) または TransformerException(String,Throwable) を使用して作成された場合、このメソッドは 1 回も呼び出すことができません。

オーバーライド:

initCause、クラス: Throwable

パラメータ:

cause - 原因 (あとで getCause() メソッドで取得できるように保存される)。(null 値が許可されており、原因が存在しないか不明であることを示す)

戻り値:

この Throwable インスタンスへの参照。

例外:

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

IllegalStateException - このスロー可能オブジェクトが TransformerException(Throwable) または TransformerException(String,Throwable) で作成されたものである場合、あるいはこのスロー可能オブジェクトでこのメソッドがすでに呼び出されていた場合。

getMessageAndLocation

public String getMessageAndLocation()

位置情報が追加されたエラーメッセージを取得します。

戻り値:

位置情報が追加されたエラーメッセージを表す String。

getLocationAsString

public String getLocationAsString()

位置情報を文字列として取得します。

戻り値:

位置情報を含む文字列。位置情報がない場合は null。

printStackTrace

public void printStackTrace()

エラーが発生した元の場所からのメソッドのトレースを出力します。これは、すべての入れ子になっている例外オブジェクト、およびこのオブジェクトを追跡します。

オーバーライド:

printStackTrace、クラス: Throwable

printStackTrace

public void printStackTrace(PrintStream s)

エラーが発生した元の場所からのメソッドのトレースを出力します。これは、すべての入れ子になっている例外オブジェクト、およびこのオブジェクトを追跡します。

オーバーライド:

printStackTrace、クラス: Throwable

パラメータ:

s - ダンプの送り先のストリーム。

printStackTrace

public void printStackTrace(PrintWriter s)

エラーが発生した元の場所からのメソッドのトレースを出力します。これは、すべての入れ子になっている例外オブジェクト、およびこのオブジェクトを追跡します。

オーバーライド:

printStackTrace、クラス: Throwable

パラメータ:

s - ダンプの送り先のライター。