Класс ElementIterator

public class ElementIterator
extends Object
implements Cloneable

Класс ElementIterator, как следует из названия, итерирует по дереву Element. Конструктор может быть вызван с документом или элементом в качестве аргумента. Если конструктор вызван с документом в качестве аргумента, то корнем итерации является значение, возвращаемое методом document.getDefaultRootElement(). Итерация происходит по принципу обхода в глубину. Что касается обработки граничных условий: а) если метод next() вызван до first() или current(), будет возвращен корень. б) next() возвращает null, чтобы указать конец списка. в) previous() возвращает null, когда текущий элемент является корнем или next() вернул null. Класс ElementIterator не блокирует дерево Element. Это означает, что он не отслеживает никаких изменений. Ответственность пользователя этого класса заключается в обеспечении того, чтобы во время итерации элементов не происходили изменения. Пример простого использования: public void iterate() { ElementIterator it = new ElementIterator(root); Element elem; while (true) { if ((elem = next()) != null) { // обработать элемент System.out.println("elem: " + elem.getName()); } else { break; } } }

Конструкторы

ElementIterator

public ElementIterator(Document document)

Создает новый ElementIterator. Корневой элемент берется для получения корневого элемента по умолчанию документа.

Параметры:

document - документ.

ElementIterator

public ElementIterator(Element root)

Создает новый ElementIterator.

Параметры:

root - корневой элемент.

Методы

clone

public Object clone()

Клонирует ElementIterator.

Переопределяет:

clone в классе Object

Возвращает:

объект ElementIterator, являющийся клоном.

См. также:

Cloneable

first

public Element first()

Возвращает первый элемент.

Возвращает:

элемент.

depth

public int depth()

Возвращает текущую глубину дерева элементов.

Возвращает:

глубину.

current

public Element current()

Возвращает текущий элемент.

Возвращает:

элемент на вершине стека или null если корневой элемент является null

next

public Element next()

Возвращает следующий элемент. Стратегия поиска следующего элемента — обход в глубину.

Возвращает:

следующий элемент или null в конце списка.

previous

public Element previous()

Возвращает предыдущий элемент. Однако, если текущий элемент является последним элементом или текущий элемент равен null, возвращается null.

Возвращает:

предыдущий элемент, если доступен