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) 当一个API提供者需要数据的一部分文档为一个信息集的表示，它首先调用这个方法来创建一个 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

Constructor Detail

W3CDomHandler

public W3CDomHandler()

默认构造函数。它是一个API提供商决定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

当一个API提供者需要数据的一部分文档为一个信息集的表示，它首先调用这个方法来创建一个 Result对象。

JAXB提供商将发送XML的一部分进入了已知的结果。这一部分总是形成子树对整个XML文档的根元素。

Specified by:

createUnmarshaller 接口 DomHandler<Element,DOMResult>

参数

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

结果

如果操作失败。错误必须已报告给错误处理程序。

getElement

public Element getElement(DOMResult r)

从接口复制的描述： DomHandler

一旦部分发送到 Result。这种方法是通过一个叫做JAXB提供商获得它们分散元素的表示。

这种方法的调用会返回多个不同的对象。这种方法可以被调用，只有当整个子树被送入Result对象。

Specified by:

getElement 接口 DomHandler<Element,DOMResult>

参数

r创造了由 DomHandler.createUnmarshaller(ValidationEventHandler)的 Result对象。

结果

如果操作失败。错误必须已报告给错误处理程序。

marshal

public Source marshal(Element element,
                      ValidationEventHandler errorHandler)

从接口复制的描述： DomHandler

这种方法被称为当JAXB提供者需要元帅元素的XML。

如果非零，返回的Source必须包含整个文档的根元素，然后将其编织成一个大文件，JAXB提供编组。

Specified by:

marshal 接口 DomHandler<Element,DOMResult>

errorHandler -接收将一元到 Source过程中发生的任何错误。调用方必须提供一个非空的错误处理程序。

结果

如果有一个错误。错误应该已报告给处理程序。