Module  java.xml
软件包  org.w3c.dom.traversal

Interface DocumentTraversal



  • public interface DocumentTraversal
    DocumentTraversal包含创建NodeIteratorsTreeWalkers以按文档顺序遍历节点及其子节点的方法(深度优先,预订遍历,等效于文档的文本表示中起始标签出现的顺序)。 在支持Traversal功能的DOM中, DocumentTraversal将由实现Document界面的相同对象实现。

    另见Document Object Model (DOM) Level 2 Traversal and Range Specification

    从以下版本开始:
    9,DOM Level 2
    • 方法详细信息

      • createNodeIterator

        NodeIterator createNodeIterator​(Node root,
                                        int whatToShow,
                                        NodeFilter filter,
                                        boolean entityReferenceExpansion)
                                 throws DOMException
        在指定节点上生成的子 NodeIterator创建一个新的 NodeIterator
        参数
        root - 将与其子节点一起迭代的节点。 NodeIterator最初位于该节点之前。 在设置此位置时,不考虑whatToShow标志和过滤器(如果有)。 根不能是null
        whatToShow - 此标志指定哪些节点类型可能出现在由NodeIterator提供的树的逻辑视图中。 请参阅NodeFilter的可能的SHOW_值的描述。这些标志可以使用OR组合。
        filter -该 NodeFilter与该使用 NodeIterator ,或 null表示没有滤波器。
        entityReferenceExpansion - 该标志的值决定是否扩展实体引用节点。
        结果
        新创 NodeIterator
        异常
        DOMException - NOT_SUPPORTED_ERR:如果指定的 rootnullnull
      • createTreeWalker

        TreeWalker createTreeWalker​(Node root,
                                    int whatToShow,
                                    NodeFilter filter,
                                    boolean entityReferenceExpansion)
                             throws DOMException
        在指定节点上生成的子 TreeWalker创建一个新的 TreeWalker
        参数
        root - 将作为root作为rootTreeWalker 设置此值时不考虑whatToShow标志和NodeFilter ; 任何节点类型将被接受为root currentNodeTreeWalker初始化为此节点,无论是否可见。 root作为在文档结构中向上看的遍历方法的停止点,如parentNode和nextNode。 root不能是null
        whatToShow - 此标志指定哪些节点类型可能出现在由TreeWalker提供的树的逻辑视图中。 请参阅NodeFilter的可能的SHOW_值的描述。这些标志可以使用OR组合。
        filter -该 NodeFilter与该使用 TreeWalker ,或 null表示没有滤波器。
        entityReferenceExpansion - 如果该标志为false,则 EntityReference节点的内容不会在逻辑视图中显示。
        结果
        新创 TreeWalker
        异常
        DOMException - NOT_SUPPORTED_ERR:如果指定的 rootnullnull