Класс ElementIterator

public class ElementIterator extends Object implements Cloneable

ElementIterator, как следует из названия, выполняет итерацию по дереву Element. Конструктор можно вызвать, передав в качестве аргумента либо Document, либо Element. Если конструктор вызван с аргументом Document, корнем итерации становится возвращаемое значение 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 = it.next()) != null) {
             // process element
             System.out.println("elem: " + elem.getName());
         } else {
             break;
         }
     }
}