javax.xml.bind

インタフェースValidationEventHandler

既知のすべての実装クラス:

DefaultValidationEventHandler, ValidationEventCollector

public interface ValidationEventHandler

検証エラーの基本イベント・ハンドラ・インタフェース。

アプリケーションは、カスタマイズされたイベント処理を実装する必要がある場合に、このインタフェースを実装し、それをUnmarshaller、Validator、またはMarshallerに登録する必要があります。この後、JAXBプロバイダは、非整列化、整列化および検証操作中に発生した検証エラーおよび警告を、これらのイベント・ハンドラに報告するようになります。

handleEventメソッドが非チェックの実行時例外をスローした場合、JAXBプロバイダは、メソッドがfalseを返したかのように、そのとき実行中の操作(非整列化、検証、または整列化)を効果的に強制終了するように処理する必要があります。

イベント・ハンドラ内のJavaコンテンツ・ツリーを変更することについては仕様で定義されておらず、予想外の動作を引き起こす可能性があります。

致命的なエラーの発生後にhandleEventメソッドからfalseを返せない場合については仕様で定義されておらず、予想外の動作を引き起こす可能性があります。

デフォルト・イベント・ハンドラ

Validatorのjavadocを参照してください。

導入されたバージョン:

JAXB1.0

関連項目:

Unmarshaller, Validator, Marshaller, ValidationEvent, ValidationEventCollector

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	handleEvent(ValidationEvent event) 検証警告またはエラーの通知を受け取ります。

メソッドの詳細

handleEvent

boolean handleEvent(ValidationEvent event)

検証警告またはエラーの通知を受け取ります。ValidationEventには、発生したエラーまたは警告の場所を示す、ValidationEventLocatorが埋め込まれます。

未確認の実行時例外がこのメソッドからスローされた場合、JAXBプロバイダはメソッドがfalseを返したかのようにそれを処理し、現在の非整列化、検証、または整列化操作を中止します。

パラメータ:

event - カプセル化された検証イベント情報。このパラメータがnullの場合は、プロバイダ・エラーとなる。

戻り値:

JAXBプロバイダがこの警告またはエラーを処理したあと、現在の非整列化、検証、または整列化操作を続行する場合はtrue。適切なUnmarshalException、ValidationException、またはMarshalExceptionを生成して現在の操作を終了させる場合はfalse。

例外:

IllegalArgumentException - イベント・オブジェクトがnullの場合。