模块  java.xml
软件包  org.w3c.dom.traversal

Interface DocumentTraversal


  • public interface DocumentTraversal
    DocumentTraversal包含创建NodeIteratorsTreeWalkers以按文档顺序遍历节点及其子节点的方法(深度优先,预先遍序遍历,这相当于文档的文本表示中出现标记的顺序)。 在支持遍历功能的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呈现的树的逻辑视图中。 有关可能的SHOW_值的集合,请参见NodeFilter的说明。可以使用OR组合这些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 - 将用作rootTreeWalker 设置此值时不考虑whatToShow标志和NodeFilter ; 任何节点类型都将被接受为root currentNodeTreeWalker初始化为此节点,无论它是否可见。 root用作在文档结构中向上查看的遍历方法的停止点,例如parentNode和nextNode。 root不得是null
        whatToShow - 该标志指定哪些节点类型可以出现在TreeWalker呈现的树的逻辑视图中。 有关可能的SHOW_值的集合,请参见NodeFilter的说明。可以使用OR组合这些OR
        filter -该 NodeFilter与该使用 TreeWalker ,或 null ,表示没有滤波器。
        entityReferenceExpansion - 如果此标志为false,则逻辑视图中不显示 EntityReference节点的内容。
        结果
        新创建的 TreeWalker
        异常
        DOMException - NOT_SUPPORTED_ERR:如果指定的 rootnullnull