Интерфейс DocumentTraversal

public interface DocumentTraversal

DocumentTraversal содержит методы, которые создают NodeIterators и TreeWalkers для обхода узла и его потомков в порядке документа (поиск в глубину, прямой обход, что эквивалентно порядку, в котором появляются открывающие теги в текстовом представлении документа). В DOM, которые поддерживают функцию Traversal, DocumentTraversal будут реализованы теми же объектами, что и интерфейс Document.

См. также Спецификацию обхода и диапазона модели объекта документа (DOM) уровня 2.

Since:: 9, DOM Level 2

Краткое описание методов

Модификатор и тип	Метод	Описание
`NodeIterator`	`createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)`	Создать новый `NodeIterator` над поддеревом, укоренённым в указанном узле.
`TreeWalker`	`createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)`	Создать новый `TreeWalker` над поддеревом, укоренённым в указанном узле.

Подробное описание методов

createNodeIterator

NodeIterator createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) throws DOMException

Создать новый NodeIterator над поддеревом, укоренённым в указанном узле.

Параметры:: root - Узел, который будет итерироваться вместе со своими потомками. NodeIterator изначально размещается непосредственно перед этим узлом. Флаги whatToShow и фильтр, если таковой имеется, не учитываются при установке этого положения. Корень не должен быть null.; whatToShow - Этот флаг указывает, какие типы узлов могут появляться в логическом представлении дерева, представленном NodeIterator. См. описание NodeFilter для набора возможных значений SHOW_. Эти флаги можно комбинировать с помощью OR.; filter - NodeFilter, который будет использоваться с этим NodeIterator, или null для обозначения отсутствия фильтра.; entityReferenceExpansion - Значение этого флага определяет, будут ли расширяться ссылки на сущности.
Возвращает:: Созданный NodeIterator.
Исключения:: DOMException - NOT_SUPPORTED_ERR: Возникает, если указанный root является null.

createTreeWalker

TreeWalker createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) throws DOMException

Создать новый TreeWalker над поддеревом, укоренённым в указанном узле.

Параметры:: root - Узел, который будет служить корнем для root TreeWalker. Флаги whatToShow и NodeFilter не учитываются при установке этого значения; любой тип узла будет принят в качестве root. currentNode TreeWalker инициализируется этим узлом, независимо от того, виден ли он. root выполняет роль точки остановки для методов обхода, которые смотрят вверх в структуре документа, таких как parentNode и nextNode. root не должен быть null.; whatToShow - Этот флаг указывает, какие типы узлов могут появляться в логическом представлении дерева, представленном TreeWalker. См. описание NodeFilter для набора возможных значений SHOW_. Эти флаги можно комбинировать с помощью OR.; filter - NodeFilter, который будет использоваться с этим TreeWalker, или null для обозначения отсутствия фильтра.; entityReferenceExpansion - Если этот флаг ложный, содержимое узлов EntityReference не отображается в логическом представлении.
Возвращает:: Созданный TreeWalker.
Исключения:: DOMException - NOT_SUPPORTED_ERR: Возникает, если указанный root является null.

© 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/DocumentTraversal.html