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

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) 警告の通知を受け取ります。

メソッドの詳細

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

回復できないエラーの通知を受け取ります。

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

パラメータ:

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

例外:

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

関連項目:

TransformerException