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

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

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