public interface NodeFilter
NodeIterator
または TreeWalker
に NodeFilter
を指定した場合、次のノードが返される前にそのフィルタが適用されます。フィルタが次のノードを受け入れるように指定すると、トラーバーサルのロジックがそのノードを返します。そうでない場合、トラバーサルは次のノードを検索し、拒否されたノードが存在していなかったように振る舞います。
DOM はフィルタを一切提供しません。NodeFilter
は、ユーザーが独自のフィルタを提供するために実装可能なインタフェースにすぎません。
NodeFilter
は、ノード間をトラバースする方法を認識している必要はなく、トラバースされているデータ構造についても認識している必要はありません。フィルタは、単一のノードを評価する方法だけを認識しておけば良いので、フィルタを記述するのはきわめて容易です。複数の種類の異なるトラバーサルで 1 つのフィルタを使用できるので、コードの再利用をお勧めします。
「Document Object Model (DOM) Level 2 Traversal and Range Specification」も参照してください。
修飾子と型 | フィールドと説明 |
---|---|
static short |
FILTER_ACCEPT
ノードを受け入れます。
|
static short |
FILTER_REJECT
ノードを拒否します。
|
static short |
FILTER_SKIP
指定した単一のノードをスキップします。
|
static int |
SHOW_ALL
すべての
Nodes を示します。 |
static int |
SHOW_ATTRIBUTE
Attr ノードを示します。 |
static int |
SHOW_CDATA_SECTION
CDATASection ノードを示します。 |
static int |
SHOW_COMMENT
Comment ノードを示します。 |
static int |
SHOW_DOCUMENT
Document ノードを示します。 |
static int |
SHOW_DOCUMENT_FRAGMENT
DocumentFragment ノードを示します。 |
static int |
SHOW_DOCUMENT_TYPE
DocumentType ノードを示します。 |
static int |
SHOW_ELEMENT
Element ノードを示します。 |
static int |
SHOW_ENTITY
Entity ノードを示します。 |
static int |
SHOW_ENTITY_REFERENCE
EntityReference ノードを示します。 |
static int |
SHOW_NOTATION
Notation ノードを示します。 |
static int |
SHOW_PROCESSING_INSTRUCTION
ProcessingInstruction ノードを示します。 |
static int |
SHOW_TEXT
Text ノードを示します。 |
修飾子と型 | メソッドと説明 |
---|---|
short |
acceptNode(Node n)
指定されたノードが
TreeWalker または NodeIterator の論理ビューで可視であるかどうかをテストします。 |
static final short FILTER_ACCEPT
NodeIterator
または TreeWalker
に定義されたナビゲーションメソッドは、このノードを返します。static final short FILTER_REJECT
NodeIterator
または TreeWalker
に定義されたナビゲーションメソッドは、このノードを返しません。TreeWalker
の場合、このノードの子も拒否されます。NodeIterators
は、このノードを FILTER_SKIP
と同義として扱います。static final short FILTER_SKIP
NodeIterator
または TreeWalker
に定義されたナビゲーションメソッドは、このノードを返しません。NodeIterator
と TreeWalker
の両方で、このノードの子は引き続き考慮されます。static final int SHOW_ALL
Nodes
を示します。static final int SHOW_ELEMENT
Element
ノードを示します。static final int SHOW_ATTRIBUTE
Attr
ノードを示します。このフィールドは、属性ノードを root
とする NodeIterator
または TreeWalker
を生成するときだけ有効です。この場合、属性ノードが反復処理またはトラバーサルの最初の位置に現れることを示します。属性は、ほかのノードの子であることはないので、ドキュメントツリー上をトラバースするときに現れません。static final int SHOW_TEXT
Text
ノードを示します。static final int SHOW_CDATA_SECTION
CDATASection
ノードを示します。static final int SHOW_ENTITY_REFERENCE
EntityReference
ノードを示します。static final int SHOW_ENTITY
Entity
ノードを示します。このフィールドは、Entity
ノードを root
とする NodeIterator
または TreeWalker
を生成するときだけ有効です。この場合、Entity
ノードがトラバーサルの最初の位置に現れることを示します。エンティティーは、ドキュメントツリーの一部ではないので、ドキュメントツリー上をトラバースするときに現れません。static final int SHOW_PROCESSING_INSTRUCTION
ProcessingInstruction
ノードを示します。static final int SHOW_COMMENT
Comment
ノードを示します。static final int SHOW_DOCUMENT
Document
ノードを示します。static final int SHOW_DOCUMENT_TYPE
DocumentType
ノードを示します。static final int SHOW_DOCUMENT_FRAGMENT
DocumentFragment
ノードを示します。static final int SHOW_NOTATION
Notation
ノードを示します。このフィールドは、Notation
ノードを root
とする NodeIterator
または TreeWalker
を生成するときだけ有効です。この場合、Notation
ノードがトラバーサルの最初の位置に現れることを示します。表記法は、ドキュメントツリーの一部ではないので、ドキュメントツリー上をトラバースするときに現れません。short acceptNode(Node n)
TreeWalker
または NodeIterator
の論理ビューで可視であるかどうかをテストします。この関数は、TreeWalker
と NodeIterator
の実装により呼び出され、通常はユーザーコードから直接呼び出されることはありません。(ただし、同じフィルタを使ってユーザー独自のアプリケーション論理を導く場合は、ユーザーコードから直接呼び出すことも可能。)n
- フィルタを通過するかどうかをチェックするノード。 バグまたは機能を送信
Java は米国ならびにその他の国における Oracle Corporation およびその関連企業の商標または登録商標です。
Copyright © 2005, 2013, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.