|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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
- アプリケーションが変換の継続解除を選択した場合TransformerException
void error(TransformerException exception) throws TransformerException
Transformer は、このメソッドを呼び出したあと、通常の変換の試行と提供を継続する必要があります。ほかのエラーが検出されなければ、アプリケーションがドキュメントを最後まで処理することは依然として可能です。
exception
- Transformer 例外にカプセル化された エラー情報
TransformerException
- アプリケーションが変換の継続解除を選択した場合TransformerException
void fatalError(TransformerException exception) throws TransformerException
回復できないエラーの通知を受け取ります。
プロセッサは処理を継続することもありますが、通常は正常に終了しません。
メソッドは、エラーを処理できない場合、またはすぐに処理を終了する場合、例外をスローします。プロセッサは必ずしもこの要求を受け入れません。
exception
- TransformerException
例外にカプセル化された エラー情報
TransformerException
- アプリケーションが変換の継続解除を選択した場合TransformerException
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。