javax.xml.bind.annotation

Class W3CDomHandler

java.lang.Object

javax.xml.bind.annotation.W3CDomHandler

All Implemented Interfaces:

DomHandler < Element ， DOMResult >

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

DomHandler W3C DOM实现（ org.w3c.dom包）

从以下版本开始：

JAXB2.0

构造方法摘要

构造方法

Constructor and Description
W3CDomHandler() 默认构造函数。
W3CDomHandler(DocumentBuilder builder) 构造函数，允许应用程序指定要使用的DOM实现。

方法摘要

Modifier and Type	Method and Description
DOMResult	createUnmarshaller(ValidationEventHandler errorHandler) 当JAXB提供者需要将文档的一部分解组成信息集表示时，它首先调用此方法来创建一个Result对象。
DocumentBuilder	getBuilder()
Element	getElement(DOMResult r) 一旦发送到Result 。
Source	marshal(Element element, ValidationEventHandler errorHandler) 当JAXB提供程序需要将元素编组为XML时，将调用此方法。
void	setBuilder(DocumentBuilder builder)

Methods inherited from class 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 - 不能为空。 JAXB使用这个DocumentBuilder来创建一个新的元素。

方法详细信息

getBuilder

public DocumentBuilder getBuilder()

setBuilder

public void setBuilder(DocumentBuilder builder)

createUnmarshaller

public DOMResult createUnmarshaller(ValidationEventHandler errorHandler)

说明从界面： DomHandler复制

当JAXB提供者需要将文档的一部分解组成信息集表示时，它首先调用此方法来创建一个Result对象。

然后，JAXB提供者将把XML的一部分发送给给定的结果。 这样的部分总是形成一个植根于元素的整个XML文档的子树。

Specified by:

createUnmarshaller在界面 DomHandler<Element,DOMResult>

参数

errorHandler -如果此方法的调用和调用之间发生任何错误DomHandler.getElement(Result) ，他们必须报该处理程序。 调用者必须提供一个非空的错误处理程序。 从此方法创建的Result对象可能会保留对此错误处理程序的引用。

结果

如果操作失败，则为null。 该错误必须已报告给错误处理程序。

getElement

public Element getElement(DOMResult r)

说明从界面： DomHandler复制

一旦发送到Result 。 此方法由JAXB提供程序调用以获取未编组的元素表示。

该方法的多次调用可能会返回不同的对象。 只有当整个子树被馈送到Result对象时，才能调用此方法。

Specified by:

getElement在界面 DomHandler<Element,DOMResult>

参数

r -该Result通过创建的对象DomHandler.createUnmarshaller(ValidationEventHandler) 。

结果

如果操作失败，则为null。 该错误必须已报告给错误处理程序。

marshal

public Source marshal(Element element,
                      ValidationEventHandler errorHandler)

说明从界面复制： DomHandler

当JAXB提供程序需要将元素编组为XML时，将调用此方法。

如果非空，则返回的Source必须包含一个以一个元素为根的整个文档，然后将其编入JAXB提供程序编组的更大的文档。

Specified by:

marshal在界面 DomHandler<Element,DOMResult>

errorHandler - 接收在将元素转换为Source的过程中发生的任何错误。 调用者必须提供一个非空的错误处理程序。

结果

如果有错误，则为null。 该错误应该已经被报告给处理程序。