モジュール java.desktop
パッケージ javax.swing.text

クラスElementIterator

java.lang.Object
javax.swing.text.ElementIterator
すべての実装されたインタフェース:
Cloneable
public class ElementIterator extends Object implements Cloneable
ElementIteratorは、名前が示すとおり、Elementツリーを反復処理します。 このコンストラクタは、DocumentまたはElementを引数として使用して呼び出すことができます。 コンストラクタが引数としてDocumentで呼び出される場合、反復のルートはdocument.getDefaultRootElement()の戻り値です。

深さ優先方式で繰り返します。 境界条件の処理方法:

  • next()がfirst()またはcurrent()の前にコールされた場合、ルートが戻されます。
  • リストの終わりを示すnullがnext()から返されます
  • 現在の要素がルートまたはnext()によってnullが戻されると、previous()は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;
          }
      }
 }