javax.xml.bind.annotation
介面 DomHandler<ElementT,ResultT extends Result>

所有已知實作類別：

W3CDomHandler

public interface DomHandler<ElementT,ResultT extends Result>

在元素（及其子代）與 DOM（或類似物件）表示形式之間相互轉換。

此介面的實作將與 XmlAnyElement 註釋一起使用，將 XML 的元素映射到資訊集（如 W3C DOM）的表示形式。

實作隱藏 XML 的一部分與這些類別 DOM 表示形式之間相互轉換的方式，並允許 JAXB 提供者處理任意這樣的資源庫。

此介面將由資源庫編寫器實作，並由 JAXB 提供者使用。這些方法都不應該從應用程序調用。

從以下版本開始：

JAXB2.0

方法摘要

ResultT	createUnmarshaller(ValidationEventHandler errorHandler) 當 JAXB 提供者需要將文檔的一部分解組為資訊集表示形式時，首先要調用此方法創建一個 Result 物件。
ElementT	getElement(ResultT rt) 將部分發送到 Result 後，JAXB 提供者將調用此方法來獲取已解組元素表示形式。
Source	marshal(ElementT n, ValidationEventHandler errorHandler) 在 JAXB 提供者需要將元素編組為 XML 時調用此方法。

方法詳細資訊

createUnmarshaller

ResultT createUnmarshaller(ValidationEventHandler errorHandler)

當 JAXB 提供者需要將文檔的一部分解組為資訊集表示形式時，首先要調用此方法創建一個 Result 物件。

然後 JAXB 提供者將 XML 的一部分發送到給定的結果中。這一部分 XML 總是可以形成整個 XML 文檔（該文檔以某個元素為根）的子階層樹。

參數：

errorHandler - 如果在調用此方法和調用 getElement(Result) 之間發生任何錯誤，則必須向此處理程序報告。 調用者必須提供一個非 null 錯誤處理程序。 從此方法創建的 Result 物件可以保存對此錯誤處理程序的參考。

返回：

如果操作失敗，則返回 null。必須向錯誤處理程序報告錯誤。

getElement

ElementT getElement(ResultT rt)

將部分發送到 Result 後，JAXB 提供者將調用此方法來獲取已解組元素表示形式。

多次調用此方法可能返回不同的物件。在將整個子階層樹填充到 Result 物件時，才可以調用此方法。

參數：

rt - 由 createUnmarshaller(ValidationEventHandler) 創建的 Result 物件。

返回：

如果操作失敗，則返回 null。必須向錯誤處理程序報告錯誤。

marshal

Source marshal(ElementT n,
               ValidationEventHandler errorHandler)

在 JAXB 提供者需要將元素編組為 XML 時調用此方法。

如果為非 null，則返回的 Source 必須包含以一個元素為根的整個文檔，該文檔隨後將被編製成一個將由 JAXB 提供者編組的更大文檔。

參數：

errorHandler - 接收將元素轉換成 Source 的過程中發生的任何錯誤。 調用者必須提供一個非 null 錯誤處理程序。

返回：

如果有錯誤，則返回 null。應該向處理程序報告該錯誤。