Интерфейс NodeFilter
- Все известные подинтерфейсы:
LSSerializerFilter
public interface NodeFilter
Фильтры — это объекты, которые знают, как «отфильтровать» узлы. Если
NodeIterator или TreeWalker получает NodeFilter, он применяет фильтр перед тем, как вернуть следующий узел. Если фильтр разрешает принять узел, логика обхода возвращает его; в противном случае обход ищет следующий узел и игнорирует тот, который был отклонен. DOM не предоставляет никаких фильтров. NodeFilter — это просто интерфейс, который пользователи могут реализовать для предоставления собственных фильтров.
NodeFilters не нужно знать, как перемещаться от узла к узлу, ни о структуре данных, по которой выполняется обход. Это значительно упрощает создание фильтров, так как единственное, что им нужно знать, — это как оценить отдельный узел. Один фильтр может использоваться с различными типами обхода, что способствует повторному использованию кода.
См. также Спецификацию Document Object Model (DOM) Level 2 Traversal and Range.
- С:
- 9, DOM Level 2
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final short |
FILTER_ACCEPT |
Принять узел. |
static final short |
FILTER_REJECT |
Отклонить узел. |
static final short |
FILTER_SKIP |
Пропустить этот единственный узел. |
static final int |
SHOW_ALL |
Показать все Nodes. |
static final int |
SHOW_ATTRIBUTE |
Показать Attr узлы. |
static final int |
SHOW_CDATA_SECTION |
Показать CDATASection узлы. |
static final int |
SHOW_COMMENT |
Показать Comment узлы. |
static final int |
SHOW_DOCUMENT |
Показать Document узлы. |
static final int |
SHOW_DOCUMENT_FRAGMENT |
Показать DocumentFragment узлы. |
static final int |
SHOW_DOCUMENT_TYPE |
Показать DocumentType узлы. |
static final int |
SHOW_ELEMENT |
Показать Element узлы. |
static final int |
SHOW_ENTITY |
Показать Entity узлы. |
static final int |
SHOW_ENTITY_REFERENCE |
Показать EntityReference узлы. |
static final int |
SHOW_NOTATION |
Показать Notation узлы. |
static final int |
SHOW_PROCESSING_INSTRUCTION |
Показать ProcessingInstruction узлы. |
static final int |
SHOW_TEXT |
Показать Text узлы. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
short |
acceptNode |
Проверка, отображается ли указанный узел в логическом представлении TreeWalker или NodeIterator. |
Подробное описание полей
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; в этом случае это означает, что узел атрибута будет отображаться на первом месте итерации или обхода. Поскольку атрибуты никогда не являются дочерними узлами других узлов, они не отображаются при обходе дерева документа.- См. также:
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; в этом случае это означает, что узел 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; в этом случае это означает, что узел Notation будет отображаться на первом месте обхода. Так как обозначения не являются частью дерева документа, они не отображаются при обходе дерева документа.- См. также:
Подробности методов
acceptNode
short acceptNode(Node n)
Проверить, отображается ли указанный узел в логическом представлении
TreeWalker или NodeIterator. Эта функция будет вызвана реализацией TreeWalker и NodeIterator; она обычно не вызывается напрямую из пользовательского кода. (Хотя вы можете сделать это, если хотите использовать тот же фильтр для руководства своей собственной логикой приложения.)- Параметры:
-
n- Узел, для проверки его соответствия фильтру. - Возвращает:
- Константу, определяющую, принимается ли узел, отклоняется или пропускается, как определено выше.
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/traversal/NodeFilter.html
