public interface ErrorListener
カスタマイズされたエラー処理を提供するには、このインタフェースを実装し、setErrorListener
メソッドを使用して、Transformer
で実装のインスタンスを登録します。Transformer
は次にこのインタフェースを介してすべてのエラーと警告をレポートします。
アプリケーションが独自のカスタム ErrorListener
を登録しない場合、デフォルトの ErrorListener
が使用され、すべての警告とエラーが System.err
にレポートされて、Exception
は何もスローされません。アプリケーションでは警告とエラーの適切な動作を確保するため、ErrorListener
を登録して使用することを強くお勧めします。
変換エラーの場合、Transformer
は Exception
をスローしないでこのインタフェースを使用する必要があります。さまざまな種類のエラーと警告に対して Exception
をスローするかどうかの判定はアプリケーションで行う必要があります。ただし、Transformer
は、fatalError(TransformerException exception)
を呼び出したあとに変換を継続する必要はありません。
Transformer
は、このメカニズムを使用して XML 解析エラーおよび変換エラーをレポートできます。
修飾子と型 | メソッドと説明 |
---|---|
void |
error(TransformerException exception)
回復可能なエラーの通知を受け取ります。
|
void |
fatalError(TransformerException exception)
回復できないエラーの通知を受け取ります。
|
void |
warning(TransformerException exception)
警告の通知を受け取ります。
|
void warning(TransformerException exception) throws TransformerException
Transformer
は、このメソッドを使用してエラーあるいは致命的なエラーでない条件をレポートできます。デフォルトの動作では何も実行されません。
このメソッドを呼び出したあと、Transformer は変換を継続する必要があります。アプリケーションがドキュメントを最後まで処理することは依然として可能です。
exception
- Transformer 例外にカプセル化された警告情報。TransformerException
- アプリケーションが変換の継続解除を選択した場合。TransformerException
void error(TransformerException exception) throws TransformerException
Transformer は、このメソッドを呼び出したあと、通常の変換の試行と提供を継続する必要があります。ほかのエラーが検出されなければ、アプリケーションがドキュメントを最後まで処理することは依然として可能です。
exception
- Transformer 例外にカプセル化されたエラー情報。TransformerException
- アプリケーションが変換の継続解除を選択した場合。TransformerException
void fatalError(TransformerException exception) throws TransformerException
回復できないエラーの通知を受け取ります。
プロセッサは処理を継続することもありますが、通常は正常に終了しません。
メソッドは、エラーを処理できない場合、またはすぐに処理を終了する場合、例外をスローします。プロセッサは必ずしもこの要求を受け入れません。
exception
- TransformerException
にカプセル化されたエラー情報。TransformerException
- アプリケーションが変換の継続解除を選択した場合。TransformerException
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.