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