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