Module java.xml
Package org.w3c.dom.traversal

Interface NodeFilter

已知的所有子接口：
LSSerializerFilter
public interface NodeFilter
过滤器是知道如何“过滤掉”节点的对象。如果给定一个NodeIterator或TreeWalker一个NodeFilter，它会在返回下一个节点之前应用过滤器。如果过滤器表示接受该节点，则遍历逻辑将返回该节点；否则，遍历将寻找下一个节点，并假装被拒绝的节点不存在。

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

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

另请参阅文档对象模型（DOM）级别2遍历和范围规范。

自从：
9，DOM级别2

  • Field Details

    • 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节点。仅在创建具有属性节点作为root的NodeIterator或TreeWalker时才有意义；在这种情况下，它意味着属性节点将出现在迭代或遍历的第一个位置。由于属性永远不是其他节点的子节点，因此在遍历文档树时它们不会出现。
      另请参阅：

    • 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节点。仅在创建具有Entity节点作为root的NodeIterator或TreeWalker时才有意义；在这种情况下，它意味着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节点。仅在创建具有Notation节点作为root的NodeIterator或TreeWalker时才有意义；在这种情况下，它意味着Notation节点将出现在遍历的第一个位置。由于符号不是文档树的一部分，因此在遍历文档树时它们不会出现。
      另请参阅：

  • Method Details

    • acceptNode

      short acceptNode(Node n)
      测试指定节点在TreeWalker或NodeIterator的逻辑视图中是否可见。此函数将由TreeWalker和NodeIterator的实现调用；通常不会直接从用户代码中调用。（尽管如果您想使用相同的过滤器来指导自己的应用程序逻辑，您也可以这样做。）
      参数：
      n - 要检查以查看是否通过过滤器的节点。
      返回：
      一个常量，用于确定节点是被接受、拒绝还是跳过，如上所定义。