Интерфейс 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 - Узел, который будет итерироваться вместе со своими потомками. Итератор вначале устанавливается непосредственно перед этим узлом. Флаги 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 - Узел, который будет служить корнем для TreeWalker. Флаги whatToShow и NodeFilter не учитываются при установке этого значения; любой тип узла будет принят в качестве root. root 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, 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/DocumentTraversal.html