JavaTM 2
Platform
Std. Ed. v1.4.0

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()
          原因が存在しないか不明な場合に、この Throwable または null の原因を返します。
 Throwable getException()
          このメソッドは、この例外がラップする例外を取得します。
 String getLocationAsString()
          位置情報を文字列として取得します。
 SourceLocator getLocator()
          メソッド getLocator は、エラーが発生した場所を指定する SourceLocator オブジェクトのインスタンスを取得します。
 String getMessageAndLocation()
          位置情報が追加されたエラメッセージを取得します。
 Throwable initCause(Throwable cause)
          指定された値に対するこの Throwable の「原因」を初期化します。
 void printStackTrace()
          エラーが発生した元の場所からのメソッドのトレ−スを出力します。
 void printStackTrace(PrintStream s)
          エラーが発生した元の場所からのメソッドのトレ−スを出力します。
 void printStackTrace(PrintWriter s)
          エラーが発生した元の場所からのメソッドのトレ−スを出力します。
 void setLocator(SourceLocator location)
          メソッド setLocator は、エラーが発生した場所を指定する SourceLocator オブジェクトのインスタンスを設定します。
 
クラス java.lang.Throwable から継承したメソッド
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, 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
e - 任意の例外

TransformerException

public TransformerException(String message,
                            SourceLocator locator)
メッセージとロケータから新しい TransformerException を作成します。

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

パラメータ:
message - エラーまたは警告メッセージ
locator - エラーまたは警告のロケータオブジェクト

TransformerException

public TransformerException(String message,
                            SourceLocator locator,
                            Throwable e)
既存の例外を TransformerException にラップします。

パラメータ:
message - エラーまたは警告メッセージ。埋め込まれた例外のメッセージを使用する場合は 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()
原因が存在しないか不明な場合に、この Throwable または null の原因を返します。原因はこの Throwable をスローさせた Throwable です。

オーバーライド:
クラス Throwable 内の getCause
戻り値:
このスロー可能オブジェクトの原因または null (原因が存在しないか未知の場合)

initCause

public Throwable initCause(Throwable cause)
指定された値に対するこの Throwable の「原因」を初期化します。原因はこの Throwable をスローさせた Throwable です。

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

オーバーライド:
クラス Throwable 内の initCause
パラメータ:
cause - 原因 (あとで getCause() メソッドで取得するために保存される)。null 値が許可されており、原因が存在しないか不明であることを示す
戻り値:
この Throwable インスタンスへの参照
例外:
IllegalArgumentException - cause がこの Throwable である場合 (Throwable はそれ自身の原因にはなれない)
IllegalStateException - この Throwable が TransformerException(Throwable) または TransformerException(String,Throwable) を使用して作成された場合、またはこのメソッドがこの Throwable に対してすでに呼び出された場合

getMessageAndLocation

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

戻り値:
位置情報が追加されたエラーメッセージを表す code>String

getLocationAsString

public String getLocationAsString()
位置情報を文字列として取得します。

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

printStackTrace

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

オーバーライド:
クラス Throwable 内の printStackTrace

printStackTrace

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

オーバーライド:
クラス Throwable 内の printStackTrace
パラメータ:
s - ダンプの送り先のストリーム

printStackTrace

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

オーバーライド:
クラス Throwable 内の printStackTrace
パラメータ:
s - ダンプの送り先のライター

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.