Интерфейс NodeFilter
- Все известные подинтерфейсы:
LSSerializerFilter
public interface NodeFilter
Фильтры — это объекты, которые умеют «фильтровать» узлы. Если
NodeIterator или TreeWalker получают NodeFilter, они применяют фильтр перед тем, как вернуть следующий узел. Если фильтр разрешает принять узел, логика обхода возвращает его; в противном случае обход ищет следующий узел и делает вид, что отклоненный узел отсутствует. DOM не предоставляет фильтры. NodeFilter — это просто интерфейс, который пользователи могут реализовать для создания собственных фильтров.
NodeFilters не нуждаются в знании обхода от узла к узлу и не нуждаются в знаниях о структуре данных, которая просматривается. Это значительно упрощает создание фильтров, поскольку им нужно только уметь оценивать отдельный узел. Один фильтр может использоваться с различными видами обходов, что способствует повторному использованию кода.
См. также Спецификацию модели объекта документа (DOM) уровня 2 для обхода и диапазона.
- С:
- 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, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.xml/org/w3c/dom/traversal/NodeFilter.html
