public interface ValidationEventHandler
用来验证错误的基本事件处理程序接口。
如果应用程序需要实现自定义事件处理,那么它必须实现此接口,然后向 Unmarshaller
、Validator
或 Marshaller
注册。JAXB 提供者随后将向这些事件处理程序报告在执行解组、编组和验证操作期间遇到的验证错误和警告。
如果 handleEvent 方法抛出未经检查的运行时异常,则 JAXB 提供者必须像该方法返回 false 那样作出相应对待,有效地终止当时正在运行的任何操作(解组、验证或编组)。
在事件处理程序中修改 Java 内容树不是规范中定义的行为,并且可能导致不可预料的行为。
遇到致命错误后未能从 handleEvent 方法返回 false 也不是一种规范中定义的行为,并且可能导致不可预料的行为。
默认事件处理程序
请参阅: Validator javadocs
Unmarshaller
,
Validator
,
Marshaller
,
ValidationEvent
,
ValidationEventCollector
方法摘要 | |
---|---|
boolean |
handleEvent(ValidationEvent event) 接收验证警告或错误的通知。 |
方法详细信息 |
---|
boolean handleEvent(ValidationEvent event)
ValidationEventLocator
嵌入通知中,以指示发生错误或警告的位置。
如果从此方法抛出未经检查的运行时异常,则 JAXB 提供者会像该方法返回 false 那样作出相应对待,并中断当前的解组、验证和编组操作。
event
- 封装的验证事件信息。如果为 null,则该信息是一个提供者错误。
IllegalArgumentException
- 如果事件对象为 null。