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

インタフェースErrorListener



  • public interface ErrorListener

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

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

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

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

    導入されたバージョン:
    1.4
    • メソッドの詳細

      • 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