Module  java.xml.bind
软件包  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提供程序使用。 这些方法都不是从应用程序中调用的。

    从以下版本开始：
    1.6，JAXB 2.0

    • 方法详细信息

      • 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。 该错误应该已经被报告给处理程序。