javax.xml.bind.annotation
類別 W3CDomHandler

java.lang.Object
  javax.xml.bind.annotation.W3CDomHandler

所有已實作的介面：

DomHandler<Element,DOMResult>

public class W3CDomHandler
extends Object
implements DomHandler<Element,DOMResult>

W3C DOM（org.w3c.dom 套件）的 DomHandler 實作。

從以下版本開始：

JAXB2.0

建構子摘要

W3CDomHandler()
預設的建構子。

W3CDomHandler(DocumentBuilder builder)
允許應用程序指定使用哪一個 DOM 實作的建構子。

方法摘要

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

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

W3CDomHandler

public W3CDomHandler()

預設的建構子。 它取決於 JAXB 提供者決定使用哪一個 DOM 實作或如何進行配置。

W3CDomHandler

public W3CDomHandler(DocumentBuilder builder)

允許應用程序指定使用哪一個 DOM 實作的建構子。

參數：

builder - 不得為 null。JAXB 使用此 DocumentBuilder 創建新的元素。

方法詳細資訊

getBuilder

public DocumentBuilder getBuilder()

setBuilder

public void setBuilder(DocumentBuilder builder)

createUnmarshaller

public DOMResult createUnmarshaller(ValidationEventHandler errorHandler)

從介面 DomHandler 複製的描述

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

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

指定者：

介面 DomHandler<Element,DOMResult> 中的 createUnmarshaller

參數：

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

返回：

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

getElement

public Element getElement(DOMResult r)

從介面 DomHandler 複製的描述

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

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

指定者：

介面 DomHandler<Element,DOMResult> 中的 getElement

參數：

r - 由 DomHandler.createUnmarshaller(ValidationEventHandler) 創建的 Result 物件。

返回：

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

marshal

public Source marshal(Element element,
                      ValidationEventHandler errorHandler)

從介面 DomHandler 複製的描述

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

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

指定者：

介面 DomHandler<Element,DOMResult> 中的 marshal

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

返回：

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