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

インタフェースErrorListener

public interface ErrorListener

カスタマイズされたエラー処理を提供するには、このインタフェースを実装し、setErrorListenerメソッドを使用して実装のインスタンスをTransformerに登録します。 Transformerは次にこのインタフェースを介してすべてのエラーと警告をレポートします。

アプリケーションが独自のカスタムErrorListenerを登録しない場合、デフォルトのErrorListenerが使用され、すべての警告とエラーがSystem.errにレポートされて、Exceptionは何もスローされません。 アプリケーションでは警告とエラーの正常な動作を確保するため、ErrorListenerを登録して使用することを強くお勧めします。

変換エラーの場合、TransformerはExceptionをスローしないでこのインタフェースを使用する必要があります。様々な種類のエラーと警告に対してExceptionをスローするかどうかの判定はアプリケーションで行う必要があります。 ただし、Transformerは、fatalError(TransformerException exception)を呼び出した後に変換を継続する必要はありません。

Transformerは、このメカニズムを使用してXML解析エラーおよび変換エラーをレポートできます。

導入されたバージョン:
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