javax.xml.bind.annotation

Interface DomHandler<ElementT,ResultT extends Result>

所有已知实现类：

W3CDomHandler

public interface DomHandler<ElementT,ResultT extends Result>

将元素（及其后代）从/转换为DOM（或类似的）表示形式。

该接口的实现将与XmlAnyElement注释一起使用，以将XML的元素映射到信息集的表示形式，如W3C DOM。

实现隐藏了XML的一部分如何转换成这种类似DOM的表示形式，允许JAXB提供者使用任意这样的库。

此接口旨在由库编写器实现并由JAXB提供程序使用。 这些方法都不是从应用程序中调用的。

从以下版本开始：

JAXB2.0

方法摘要

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

方法详细信息

createUnmarshaller

ResultT createUnmarshaller(ValidationEventHandler errorHandler)

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

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

参数

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

结果

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

getElement

ElementT getElement(ResultT rt)

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

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

参数

rt -该Result通过创建的对象createUnmarshaller(ValidationEventHandler) 。

结果

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

marshal

Source marshal(ElementT n,
               ValidationEventHandler errorHandler)

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

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

参数

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

结果

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