-
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
-
-