Интерфейс DocumentTraversal

public interface DocumentTraversal

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

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

С версии:: 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. Возможные значения SHOW_ см. в описании NodeFilter. Эти флаги можно объединять с помощью 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 допускается узел любого типа. TreeWalker объекта currentNode инициализируется этим узлом независимо от того, видим он или нет. root служит точкой остановки для методов обхода, которые перемещаются вверх по структуре документа, например parentNode и nextNode. root не должен быть null.; whatToShow — этот флаг определяет, какие типы узлов могут присутствовать в логическом представлении дерева, предоставляемом TreeWalker. Возможные значения SHOW_ см. в описании NodeFilter. Эти флаги можно объединять с помощью OR.; filter — NodeFilter, используемый с этим TreeWalker, или null, если фильтр не нужен.; entityReferenceExpansion — если значение этого флага равно false, содержимое узлов 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/traversal/DocumentTraversal.html