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 の場合。