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