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