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 - アプリケーションが変換の継続解除を選択した場合。TransformerExceptionvoid error(TransformerException exception) throws TransformerException
Transformerは、このメソッドを呼び出したあと、通常の変換の試行と提供を継続する必要があります。 ほかのエラーが検出されなければ、アプリケーションがドキュメントを最後まで処理することは依然として可能です。
exception - Transformer例外にカプセル化されたエラー情報。TransformerException - アプリケーションが変換の継続解除を選択した場合。TransformerExceptionvoid fatalError(TransformerException exception) throws TransformerException
回復できないエラーの通知を受け取ります。
プロセッサは処理を継続することもありますが、通常は正常に終了しません。
メソッドは、エラーを処理できない場合、またはすぐに処理を終了する場合、例外をスローします。 プロセッサは必ずしもこの要求を受け入れません。
exception - TransformerExceptionにカプセル化されたエラー情報。TransformerException - アプリケーションが変換の継続解除を選択した場合。TransformerException バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。