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

Interface NodeFilter

  • All Known Subinterfaces:
    LSSerializerFilter 
    public interface NodeFilter
    过滤器是知道如何“过滤”节点的对象。 如果为NodeIterator或TreeWalker提供了NodeFilter ，则它会在返回下一个节点之前应用过滤器。 如果过滤器说接受节点，则遍历逻辑返回它; 否则，遍历查找下一个节点并假装被拒绝的节点不在那里。

    DOM不提供任何过滤器。 NodeFilter只是用户可以实现的接口，以提供自己的过滤器。

    NodeFilters不需要知道如何从一个节点遍历到NodeFilters节点，也不需要知道任何有关正在遍历的数据结构的信息。 这使得编写过滤器变得非常容易，因为他们必须知道如何做才能评估单个节点。 一个过滤器可以与许多不同类型的遍历一起使用，从而鼓励代码重用。

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

    从以下版本开始：
    9，DOM Level 2

    • 字段详细信息

      • FILTER_ACCEPT

        static final short FILTER_ACCEPT
        接受节点。 为NodeIterator或TreeWalker定义的导航方法将返回此节点。
        另请参见：
        常数字段值

      • FILTER_REJECT

        static final short FILTER_REJECT
        拒绝节点。 为NodeIterator或TreeWalker定义的导航方法不会返回此节点。 对于TreeWalker ，此节点的子节点也将被拒绝。 NodeIterators将此视为FILTER_SKIP的同义词。
        另请参见：
        常数字段值

      • FILTER_SKIP

        static final short FILTER_SKIP
        跳过此单个节点。 为NodeIterator或TreeWalker定义的导航方法不会返回此节点。 对于NodeIterator和TreeWalker ，仍将考虑此节点的子节点。
        另请参见：
        常数字段值

      • SHOW_ALL

        static final int SHOW_ALL
        全部显示 Nodes 。
        另请参见：
        常数字段值

      • SHOW_ELEMENT

        static final int SHOW_ELEMENT
        显示 Element节点。
        另请参见：
        常数字段值

      • SHOW_ATTRIBUTE

        static final int SHOW_ATTRIBUTE
        显示Attr节点。 仅当创建具有属性节点的NodeIterator或TreeWalker作为其root ， root ; 在这种情况下，它意味着属性节点将出现在迭代或遍历的第一个位置。 由于属性从不是其他节点的子节点，因此在遍历文档树时不会显示它们。
        另请参见：
        常数字段值

      • SHOW_TEXT

        static final int SHOW_TEXT
        显示 Text节点。
        另请参见：
        常数字段值

      • SHOW_CDATA_SECTION

        static final int SHOW_CDATA_SECTION
        显示 CDATASection节点。
        另请参见：
        常数字段值

      • SHOW_ENTITY_REFERENCE

        static final int SHOW_ENTITY_REFERENCE
        显示 EntityReference节点。
        另请参见：
        常数字段值

      • SHOW_ENTITY

        static final int SHOW_ENTITY
        显示Entity节点。 仅当创建NodeIterator或TreeWalker并将Entity节点作为其root ， root ; 在这种情况下，这意味着Entity节点将出现在遍历的第一个位置。 由于实体不是文档树的一部分，因此在遍历文档树时不会显示它们。
        另请参见：
        常数字段值

      • SHOW_PROCESSING_INSTRUCTION

        static final int SHOW_PROCESSING_INSTRUCTION
        显示 ProcessingInstruction节点。
        另请参见：
        常数字段值

      • SHOW_COMMENT

        static final int SHOW_COMMENT
        显示 Comment节点。
        另请参见：
        常数字段值

      • SHOW_DOCUMENT

        static final int SHOW_DOCUMENT
        显示 Document节点。
        另请参见：
        常数字段值

      • SHOW_DOCUMENT_TYPE

        static final int SHOW_DOCUMENT_TYPE
        显示 DocumentType节点。
        另请参见：
        常数字段值

      • SHOW_DOCUMENT_FRAGMENT

        static final int SHOW_DOCUMENT_FRAGMENT
        显示 DocumentFragment节点。
        另请参见：
        常数字段值

      • SHOW_NOTATION

        static final int SHOW_NOTATION
        显示Notation节点。 仅当创建NodeIterator或TreeWalker并将Notation节点作为其root ， root ; 在这种情况下，这意味着Notation节点将出现在遍历的第一个位置。 由于符号不是文档树的一部分，因此在遍历文档树时不会出现这些符号。
        另请参见：
        常数字段值

    • 方法详细信息

      • acceptNode

        short acceptNode​(Node n)
        测试指定节点在TreeWalker或NodeIterator的逻辑视图中是否可见。 该函数将由TreeWalker和NodeIterator的实现NodeIterator ; 它通常不直接从用户代码调用。 （如果您想使用相同的过滤器来指导您自己的应用程序逻辑，您可以这样做。）
        参数
        n - 要检查它是否通过过滤器的节点。
        结果
        A constant to determine whether the node is accepted, rejected, or skipped, as defined above.