javax.xml.bind
介面 ValidationEventHandler

所有已知實作類別：

DefaultValidationEventHandler, ValidationEventCollector

public interface ValidationEventHandler

用來驗證錯誤的基本事件處理程序介面。

如果應用程序需要實作自定義事件處理，那麼它必須實作此介面，然後向 Unmarshaller、Validator 或 Marshaller 註冊。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；如果提供者應該使用適當的 UnmarshalException、ValidationException 或 MarshalException 終止當前操作，則返回 false。

拋出：

IllegalArgumentException - 如果事件物件為 null。