compact2, compact3

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

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

プロセッサは処理を継続することもありますが、通常は正常に終了しません。

メソッドは、エラーを処理できない場合、またはすぐに処理を終了する場合、例外をスローします。プロセッサは必ずしもこの要求を受け入れません。

パラメータ:

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

例外:

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

関連項目:

TransformerException