Module java.xml.bind

软件包 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包）

从以下版本开始：

1.6，JAXB 2.0

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	方法	描述
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。 该错误应该已经被报告给处理程序。