Класс 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;
         }
     }
}