JavaTM Platform
Standard Ed. 6

javax.xml.bind
接口 ValidationEventHandler

所有已知实现类:
DefaultValidationEventHandler, ValidationEventCollector

public interface ValidationEventHandler

用来验证错误的基本事件处理程序接口。

如果应用程序需要实现自定义事件处理,那么它必须实现此接口,然后向 UnmarshallerValidatorMarshaller 注册。JAXB 提供者随后将向这些事件处理程序报告在执行解组、编组和验证操作期间遇到的验证错误和警告。

如果 handleEvent 方法抛出未经检查的运行时异常,则 JAXB 提供者必须像该方法返回 false 那样作出相应对待,有效地终止当时正在运行的任何操作(解组、验证或编组)。

在事件处理程序中修改 Java 内容树不是规范中定义的行为,并且可能导致不可预料的行为。

遇到致命错误后未能从 handleEvent 方法返回 false 也不是一种规范中定义的行为,并且可能导致不可预料的行为。

默认事件处理程序

请参阅:Validator javadocs

从以下版本开始:
JAXB1.0
另请参见:
Unmarshaller, Validator, Marshaller, ValidationEvent, ValidationEventCollector

方法摘要
 boolean handleEvent(ValidationEvent event)
          接收验证警告或错误的通知。
 

方法详细信息

handleEvent

boolean handleEvent(ValidationEvent event)
接收验证警告或错误的通知。ValidationEvent 将 ValidationEventLocator 嵌入通知中,以指示发生错误或警告的位置。

如果从此方法抛出未经检查的运行时异常,则 JAXB 提供者会像该方法返回 false 那样作出相应对待,并中断当前的解组、验证和编组操作。

参数:
event - 封装的验证事件信息。如果为 null,则该信息是一个提供者错误。
返回:
如果 JAXB 提供者应该在处理此警告/错误之后尝试继续执行当前的解组、验证或编组操作,则返回 true;如果提供者应该使用适当的 UnmarshalExceptionValidationExceptionMarshalException 终止当前操作,则返回 false。
抛出:
IllegalArgumentException - 如果事件对象为 null。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策