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

Interface DocumentTraversal

  • public interface DocumentTraversal
    DocumentTraversal包含创建NodeIterators和TreeWalkers以按文档顺序遍历节点及其子节点的方法（深度优先，预先遍序遍历，这相当于文档的文本表示中出现标记的顺序）。 在支持遍历功能的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：如果指定的 root是 null则 null 。

      • createTreeWalker

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