public interface NodeIterator
NodeIterator
はノードのセットをたどるために使用されます。ノードのセットには、NodeList
に含まれるノードのセット、特定の Node
により支配されるドキュメントサブツリー、クエリーの結果、その他のノードのセットがあります。反復処理されるノードのセットは、NodeIterator
の実装により判定されます。DOM Level 2 では、ドキュメントサブツリーのドキュメント順トラバーサルに対応する単一の NodeIterator
実装が指定されています。これらの NodeIterator
のインスタンスは、DocumentTraversal
.createNodeIterator()
を呼び出して生成されます。
「Document Object Model (DOM) Level 2 Traversal and Range Specification」も参照してください。
修飾子と型 | メソッドと説明 |
---|---|
void |
detach()
NodeIterator が反復処理したセットから NodeIterator を切り離し、計算のリソースを解放して NodeIterator を INVALID 状態にします。 |
boolean |
getExpandEntityReferences()
このフラグの値は、実体参照ノードの子が
NodeIterator から可視かどうかを判定します。 |
NodeFilter |
getFilter()
ノードの選別に使用される
NodeFilter 。 |
Node |
getRoot()
作成時に指定された
NodeIterator の root ノード。 |
int |
getWhatToShow()
この属性は、
NodeIterator を使用して表されるノード型を判定します。 |
Node |
nextNode()
セットの次のノードを返して、
NodeIterator のセットでの位置を進めます。 |
Node |
previousNode()
セットの前のノードを返し、
NodeIterator のセットでの位置を戻します。 |
Node getRoot()
NodeIterator
の root ノード。int getWhatToShow()
NodeIterator
を使用して表されるノード型を判定します。利用可能な定数のセットは、NodeFilter
インタフェースで定義されます。whatToShow
によって受け入れられないノードはスキップされますが、ノードの子は引き続き考慮されます。フィルタがある場合、このスキップはフィルタよりも優先されます。NodeFilter getFilter()
NodeFilter
。boolean getExpandEntityReferences()
NodeIterator
から可視かどうかを判定します。false の場合、子とその子孫は拒否されます。この拒否は、whatToShow
とフィルタよりも優先されます。これは、現在のところ、NodeIterator
が個々のノードをスキップしないでサブツリー全体を拒否できる唯一の状況でもあります。NodeIterator
の作成時に whatToShow
フラグを使用して実体参照ノードを非表示にし、expandEntityReferences
を true に設定します。実体参照ノードを持ち、実体展開を持たないドキュメントのビューを生成するには、whatToShow
フラグを使用して実体参照ノードを表示し、expandEntityReferences
を false に設定します。Node nextNode() throws DOMException
NodeIterator
のセットでの位置を進めます。NodeIterator
が生成されたあと、nextNode()
への最初の呼び出しではセットの最初のノードが返されます。Node
、セットにこれ以上メンバーがない場合は null
。DOMException
- INVALID_STATE_ERR: detach
メソッドが呼び出されたあと、このメソッドが呼び出された場合に発生する。Node previousNode() throws DOMException
NodeIterator
のセットでの位置を戻します。Node
、セットにこれ以上メンバーがない場合は null
。DOMException
- INVALID_STATE_ERR: detach
メソッドが呼び出されたあと、このメソッドが呼び出された場合に発生する。void detach()
NodeIterator
が反復処理したセットから NodeIterator を切り離し、計算のリソースを解放して NodeIterator
を INVALID 状態にします。detach
が呼び出されると、nextNode
または previousNode
への呼び出しで INVALID_STATE_ERR 例外が発生します。 バグまたは機能を送信
Java は米国ならびにその他の国における Oracle Corporation およびその関連企業の商標または登録商標です。
Copyright © 2005, 2013, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.