モジュール java.xml
パッケージ javax.xml.transform

インタフェースErrorListener

public interface ErrorListener
変換プロセス中に発生したエラー・メッセージを通知するために、TransformerFactoryまたはTransformerによって使用されるリスナー・インタフェース。 ErrorListenerは、3レベルのメッセージを受信: 警告、エラーおよび致命的エラーは、重大度ごとに分類されます。 それぞれのアドレスは、それぞれのメソッドで説明されているように処理されます。

ErrorListenerインスタンスは、TransformerFactory.setErrorListener(ErrorListener)またはTransformer.setErrorListener(ErrorListener)メソッドを介してTransformerFactoryまたはTransformerに登録すると、TransformerFactoryまたはTransformerで報告されたエラーと警告を受信できます。

リスナーを登録する場合、TransformerFactoryまたはTransformerは、このインタフェースを使用してすべての警告およびエラーをリスナーに渡し、アプリケーションにそれらの処理方法を決定させる必要があります。 fatalError(TransformerException exception)をコールした後に変換を続行するために、TransformerFactoryまたはTransformerは必要ありません。

アプリケーションがリスナーを提供しない場合、TransformerFactoryまたはTransformerはそれ自体にリスナーを作成します。 デフォルトのErrorListenerでは、警告やリカバリ可能なエラーに対してアクションが実行されず、変換が続行できる場合があります。 ただし、処理を続行できないと判断した場合でも、TransformerFactoryまたはTransformerがTransformerExceptionをスローする可能性があります。

APIのノート:
警告およびエラーを正しく処理できるように、アプリケーションで独自のErrorListenerを登録して使用し、デフォルトの動作をオーバーライドすることをお薦めします。
導入されたバージョン:
1.4

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    void error​(TransformerException exception)
    回復可能なエラーの通知を受け取ります。
    void fatalError​(TransformerException exception)
    回復できないエラーの通知を受け取ります。
    void warning​(TransformerException exception)
    警告の通知を受け取ります。

  • メソッドの詳細

    • warning

      void warning​(TransformerException exception) throws TransformerException
      警告の通知を受け取ります。

      Transformerは、このメソッドを使用してエラーあるいは致命的なエラーでない条件をレポートできます。 デフォルトの動作では何も実行されません。

      このメソッドを呼び出したあと、Transformerは変換を継続する必要があります。 アプリケーションがドキュメントを最後まで処理することは依然として可能です。

      パラメータ:
      exception - Transformer例外にカプセル化された警告情報。
      例外:
      TransformerException - アプリケーションが変換の継続解除を選択した場合。
      関連項目:
      TransformerException

    • error

      void error​(TransformerException exception) throws TransformerException
      回復可能なエラーの通知を受け取ります。

      Transformerは、このメソッドを呼び出したあと、通常の変換の試行と提供を継続する必要があります。 ほかのエラーが検出されなければ、アプリケーションがドキュメントを最後まで処理することは依然として可能です。

      パラメータ:
      exception - Transformer例外にカプセル化されたエラー情報。
      例外:
      TransformerException - アプリケーションが変換の継続解除を選択した場合。
      関連項目:
      TransformerException

    • fatalError

      void fatalError​(TransformerException exception) throws TransformerException

      回復できないエラーの通知を受け取ります。

      プロセッサは処理を継続することもありますが、通常は正常に終了しません。

      メソッドは、エラーを処理できない場合、またはすぐに処理を終了する場合、例外をスローします。 プロセッサは必ずしもこの要求を受け入れません。

      パラメータ:
      exception - TransformerExceptionにカプセル化されたエラー情報。
      例外:
      TransformerException - アプリケーションが変換の継続解除を選択した場合。
      関連項目:
      TransformerException