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