JavaTM Platform
Standard Ed. 6

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

方法摘要
 ResultT createUnmarshaller(ValidationEventHandler errorHandler)
          当 JAXB 提供者需要将文档的一部分解组为信息集表示形式时,首先要调用此方法创建一个 Result 对象。
 ElementT getElement(ResultT rt)
          将部分发送到 Result 后,JAXB 提供者将调用此方法来获取已解组元素表示形式。
 Source marshal(ElementT n, ValidationEventHandler errorHandler)
          在 JAXB 提供者需要将元素编组为 XML 时调用此方法。
 

方法详细信息

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。应该向处理程序报告该错误。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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