Интерфейс DocumentTraversal

public interface DocumentTraversal

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

См. также Спецификацию Document Object Model (DOM) Level 2 Traversal и Range.

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 - Узел, который будет итерироваться вместе со своими дочерними узлами. Итератор изначально находится перед этим узлом. Флаги 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, 2023, 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/21/docs/api/java.xml/org/w3c/dom/traversal/DocumentTraversal.html