DomHandler - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

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

概述