クラスTransformerException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.xml.transform.TransformerException
すべての実装されたインタフェース:
Serializable
直系の既知のサブクラス:
TransformerConfigurationException
public class TransformerException extends Exception
このクラスは、変換処理中に発生した例外条件を指定します。
導入されたバージョン:
1.4
関連項目:

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

    コンストラクタ
    コンストラクタ
    説明
    TransformerException(String message)
    新しいTransformerExceptionを作成します。
    TransformerException(String message, Throwable e)
    既存の例外をTransformerExceptionにラップします。
    TransformerException(String message, SourceLocator locator)
    メッセージとロケータから新しいTransformerExceptionを作成します。
    TransformerException(String message, SourceLocator locator, 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オブジェクトのインスタンスを設定します。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, setStackTrace, toString
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    String
    getMessage()
    このスロー可能オブジェクトの詳細メッセージ文字列を返します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。
    String
    toString()
    このスロー可能オブジェクトの短い記述を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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

      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 - ダンプの送り先のライター。