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。应该向处理程序报告该错误。