javax.swing.text
クラス ElementIterator

java.lang.Object
  |
  +--javax.swing.text.ElementIterator

すべての実装インタフェース:

Cloneable

public class ElementIterator

extends Object

implements Cloneable

ElementIterator は、その名前が示すとおり、要素ツリーを繰り返し処理します。コンストラクタを呼び出すには、ドキュメントまたは要素を引数に使います。ドキュメントを引数としてコンストラクタを呼び出すと、繰り返しのルートは document.getDefaultRootElement() の戻り値になります。 深さ優先方式で繰り返します。境界の処理法は次のとおりです。a) first() または current() より先に next() が呼び出された場合は、ルートを返します。b) next() は null を返してリストの末尾を示します。c) 現在の要素がルートの場合、または next() が null を返した場合は、previous() は null を返します。 ElementIterator は要素ツリーをロックしません。つまり、ElementIterator はどのような変更も追跡しません。このクラスのユーザが、要素の繰り返し処理で変更が生じていないことを確認する必要があります。 次に、簡単な使用例を示します。

    public void iterate() {
        ElementIterator it = new ElementIterator(root);
	  Element elem;
	  while (true) {
           if ((elem = next()) != null) {
		 // process element
		 System.out.println("elem: " + elem.getName());
	     } else {
	         break;
	     }
	  }
    }

コンストラクタの概要

ElementIterator(Document document)
新しい ElementIterator を作成します。

ElementIterator(Element root)
新しい ElementIterator を作成します。

メソッドの概要

Object	clone() ElementIterator を複製します。
Element	current() 現在の Element を取り出します。
int	depth() 要素ツリーの現在の深さを取り出します。
Element	first() 先頭の要素を取り出します。
Element	next() 次の Element を取り出します。
Element	previous() 直前の Element を取り出します。

クラス java.lang.Object から継承したメソッド

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ElementIterator

public ElementIterator(Document document)

新しい ElementIterator を作成します。ルート要素を取り込むと、ドキュメントのデフォルトのルート要素を取得できます。

パラメータ:

a - ドキュメント

ElementIterator

public ElementIterator(Element root)

新しい ElementIterator を作成します。

パラメータ:

root - ルート Element

メソッドの詳細

clone

public Object clone()

ElementIterator を複製します。

オーバーライド:

クラス Object 内の clone

戻り値:

複製した ElementIterator Object

first

public Element first()

先頭の要素を取り出します。

戻り値:

Element

depth

public int depth()

要素ツリーの現在の深さを取り出します。

戻り値:

深さ

current

public Element current()

現在の Element を取り出します。

戻り値:

スタック上の要素。ルート要素が null の場合は null

next

public Element next()

次の Element を取り出します。次の要素を見つけるには深さ優先探索が使われます。

戻り値:

次の要素。リスト末尾では null

previous

public Element previous()

直前の Element を取り出します。現在の要素が最後の要素か null の場合は、null が返されます。

戻り値:

利用できる場合は前の要素