TransformerFactory
またはTransformer
によって使用されるリスナー・インタフェース。 ErrorListenerは、3レベルのメッセージを受信: 警告、エラーおよび致命的エラーは、重大度ごとに分類されます。 それぞれのアドレスは、それぞれのメソッドで説明されているように処理されます。
ErrorListenerインスタンスは、TransformerFactory.setErrorListener(ErrorListener)
またはTransformer.setErrorListener(ErrorListener)
メソッドを介してTransformerFactory
またはTransformer
に登録すると、TransformerFactoryまたはTransformerで報告されたエラーと警告を受信できます。
リスナーを登録する場合、TransformerFactory
またはTransformer
は、このインタフェースを使用してすべての警告およびエラーをリスナーに渡し、アプリケーションにそれらの処理方法を決定させる必要があります。 fatalError(TransformerException exception)
をコールした後に変換を続行するために、TransformerFactory
またはTransformer
は必要ありません。
アプリケーションがリスナーを提供しない場合、TransformerFactory
またはTransformer
はそれ自体にリスナーを作成します。 デフォルトのErrorListener
では、警告やリカバリ可能なエラーに対してアクションが実行されず、変換が続行できる場合があります。 ただし、処理を続行できないと判断した場合でも、TransformerFactory
またはTransformer
がTransformerException
をスローする可能性があります。
- APIのノート:
- 警告およびエラーを正しく処理できるように、アプリケーションで独自の
ErrorListener
を登録して使用し、デフォルトの動作をオーバーライドすることをお薦めします。 - 導入されたバージョン:
- 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
- アプリケーションが変換の継続解除を選択した場合。- 関連項目:
-
error
void error(TransformerException exception) throws TransformerException 回復可能なエラーの通知を受け取ります。Transformerは、このメソッドを呼び出したあと、通常の変換の試行と提供を継続する必要があります。 ほかのエラーが検出されなければ、アプリケーションがドキュメントを最後まで処理することは依然として可能です。
- パラメータ:
exception
- Transformer例外にカプセル化されたエラー情報。- 例外:
TransformerException
- アプリケーションが変換の継続解除を選択した場合。- 関連項目:
-
fatalError
void fatalError(TransformerException exception) throws TransformerException 回復できないエラーの通知を受け取ります。
プロセッサは処理を継続することもありますが、通常は正常に終了しません。
メソッドは、エラーを処理できない場合、またはすぐに処理を終了する場合、例外をスローします。 プロセッサは必ずしもこの要求を受け入れません。
- パラメータ:
exception
-TransformerException
にカプセル化されたエラー情報。- 例外:
TransformerException
- アプリケーションが変換の継続解除を選択した場合。- 関連項目:
-