javax.xml.transform
インタフェース ErrorListener

public interface ErrorListener

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

アプリケーションが ErrorListener を登録「しない」場合、エラーは System.err にレポートされます。

変換エラーの場合、Transformer は例外をスローしないでこのインタフェースを使用する必要があります。異なるタイプのエラーと警告に関する例外をスローするかどうかの判定はアプリケーションで行う必要があります。ただし、Transformer は、fatalError を呼び出したあとに変換を継続する必要はありません。

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

メソッドの概要

void	error(TransformerException exception) 回復可能なエラーの通知を受け取ります。
void	fatalError(TransformerException exception) 回復不能なエラーの通知を受け取ります。
void	warning(TransformerException exception) 警告の通知を受け取ります。

メソッドの詳細

warning

public void warning(TransformerException exception)
             throws TransformerException

警告の通知を受け取ります。

Transformer は、このメソッドを使用して回復可能なエラーではない警告をレポートできます。デフォルトの動作では何も実行されません。

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

パラメータ:

exception - Transformer 例外にカプセル化された警告情報

例外:

TransformerException - アプリケーションが変換の継続解除を選択した場合

関連項目:

TransformerException

error

public void error(TransformerException exception)
           throws TransformerException

回復可能なエラーの通知を受け取ります。

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

パラメータ:

exception - Transformer 例外にカプセル化されたエラー情報

例外:

TransformerException - アプリケーションが変換の継続解除を選択した場合

関連項目:

TransformerException

fatalError

public void fatalError(TransformerException exception)
                throws TransformerException

回復不能なエラーの通知を受け取ります。

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

パラメータ:

exception - Transformer 例外にカプセル化されたエラー情報

例外:

TransformerException - アプリケーションが変換の継続解除を選択した場合

関連項目:

TransformerException