javax.xml.bind.annotation
接口 DomHandler<ElementT,ResultT extends Result>

所有已知实现类：

W3CDomHandler

public interface DomHandler<ElementT,ResultT extends Result>

在元素（及其子代）与 DOM（或类似对象）表示形式之间相互转换。

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

实现隐藏 XML 的一部分与这些类 DOM 表示形式之间相互转换的方式，并允许 JAXB 提供者处理任意这样的库。

此接口将由库编写器实现，并由 JAXB 提供者使用。这些方法都不应该从应用程序调用。

从以下版本开始：

JAXB2.0

createUnmarshaller

ResultT createUnmarshaller(ValidationEventHandler errorHandler)

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

然后 JAXB 提供者将 XML 的一部分发送到给定的结果中。这一部分 XML 总是可以形成整个 XML 文档（该文档以某个元素为根）的子树。

参数：

errorHandler - 如果在调用此方法和调用 getElement(Result) 之间发生任何错误，则必须向此处理程序报告。 调用者必须提供一个非 null 错误处理程序。 从此方法创建的 Result 对象可以保存对此错误处理程序的引用。

返回：

如果操作失败，则返回 null。必须向错误处理程序报告错误。

getElement

ElementT getElement(ResultT rt)

将部分发送到 Result 后，JAXB 提供者将调用此方法来获取已解组元素表示形式。

多次调用此方法可能返回不同的对象。在将整个子树填充到 Result 对象时，才可以调用此方法。

参数：

rt - 由 createUnmarshaller(ValidationEventHandler) 创建的 Result 对象。

返回：

如果操作失败，则返回 null。必须向错误处理程序报告错误。

marshal

Source marshal(ElementT n,
               ValidationEventHandler errorHandler)

在 JAXB 提供者需要将元素编组为 XML 时调用此方法。

如果为非 null，则返回的 Source 必须包含以一个元素为根的整个文档，该文档随后将被编制成一个将由 JAXB 提供者编组的更大文档。

参数：

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

返回：

如果有错误，则返回 null。应该向处理程序报告该错误。

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