-
- 既知のすべてのサブインタフェース:
LSSerializerFilter
public interface NodeFilter
フィルタは、ノードを「フィルタ処理する」方法を知っているオブジェクトです。NodeIterator
またはTreeWalker
にNodeFilter
を指定した場合、次のノードが返される前にそのフィルタが適用されます。 フィルタが次のノードを受け入れるように指定すると、トラバーサルのロジックがそのノードを返します。そうでない場合、トラバーサルは次のノードを検索し、拒否されたノードが存在していなかったように振る舞います。DOMはフィルタを一切提供しません。
NodeFilter
は、ユーザーが独自のフィルタを提供するために実装可能なインタフェースにすぎません。NodeFilter
は、ノード間をトラバースする方法を認識している必要はなく、トラバースされているデータ構造についても認識している必要はありません。 フィルタは、単一のノードを評価する方法だけを認識しておけば良いので、フィルタを記述するのはきわめて容易です。 複数の種類の異なるトラバーサルで1つのフィルタを使用できるので、コードの再利用をお勧めします。「Document Object Model (DOM) Level 2 Traversal and Range Specification」も参照してください。
- 導入されたバージョン:
- 9、DOMレベル2
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 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
の論理ビューで可視であるかどうかをテストします。
-
-
-
フィールドの詳細
-
FILTER_ACCEPT
static final short FILTER_ACCEPT
ノードを受け入れます。NodeIterator
またはTreeWalker
に定義されたナビゲーション・メソッドは、このノードを返します。- 関連項目:
- 定数フィールド値
-
FILTER_REJECT
static final short FILTER_REJECT
ノードを拒否します。NodeIterator
またはTreeWalker
に定義されたナビゲーション・メソッドは、このノードを返しません。TreeWalker
の場合、このノードの子も拒否されます。NodeIterators
は、このノードをFILTER_SKIP
と同義として扱います。- 関連項目:
- 定数フィールド値
-
FILTER_SKIP
static final short FILTER_SKIP
指定した単一のノードをスキップします。NodeIterator
またはTreeWalker
に定義されたナビゲーション・メソッドは、このノードを返しません。NodeIterator
とTreeWalker
の両方で、このノードの子は引き続き考慮されます。- 関連項目:
- 定数フィールド値
-
SHOW_ALL
static final int SHOW_ALL
すべてのNodes
を示します。- 関連項目:
- 定数フィールド値
-
SHOW_ELEMENT
static final int SHOW_ELEMENT
Element
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_ATTRIBUTE
static final int SHOW_ATTRIBUTE
Attr
ノードを示します。 このフィールドは、属性ノードをroot
とするNodeIterator
またはTreeWalker
を生成するときにのみ有効です。この場合、属性ノードが反復処理またはトラバーサルの最初の位置に現れることを示します。 属性は、他のノードの子であることはないので、ドキュメント・ツリー上をトラバースするときに現れません。- 関連項目:
- 定数フィールド値
-
SHOW_TEXT
static final int SHOW_TEXT
Text
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_CDATA_SECTION
static final int SHOW_CDATA_SECTION
CDATASection
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_ENTITY_REFERENCE
static final int SHOW_ENTITY_REFERENCE
EntityReference
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_ENTITY
static final int SHOW_ENTITY
Entity
ノードを示します。 このフィールドは、Entity
ノードをroot
とするNodeIterator
またはTreeWalker
を生成するときにのみ有効です。この場合、Entity
ノードがトラバーサルの最初の位置に現れることを示します。 エンティティは、ドキュメント・ツリーの一部ではないので、ドキュメント・ツリー上をトラバースするときに現れません。- 関連項目:
- 定数フィールド値
-
SHOW_PROCESSING_INSTRUCTION
static final int SHOW_PROCESSING_INSTRUCTION
ProcessingInstruction
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_COMMENT
static final int SHOW_COMMENT
Comment
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_DOCUMENT
static final int SHOW_DOCUMENT
Document
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_DOCUMENT_TYPE
static final int SHOW_DOCUMENT_TYPE
DocumentType
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_DOCUMENT_FRAGMENT
static final int SHOW_DOCUMENT_FRAGMENT
DocumentFragment
ノードを示します。- 関連項目:
- 定数フィールド値
-
SHOW_NOTATION
static final int SHOW_NOTATION
Notation
ノードを示します。 このフィールドは、Notation
ノードをroot
とするNodeIterator
またはTreeWalker
を生成するときにのみ有効です。この場合、Notation
ノードがトラバーサルの最初の位置に現れることを示します。 表記法は、ドキュメント・ツリーの一部ではないので、ドキュメント・ツリー上をトラバースするときに現れません。- 関連項目:
- 定数フィールド値
-
-
メソッドの詳細
-
acceptNode
short acceptNode(Node n)
指定されたノードがTreeWalker
またはNodeIterator
の論理ビューで可視であるかどうかをテストします。 この関数は、TreeWalker
とNodeIterator
の実装により呼び出され、通常はユーザー・コードから直接呼び出されることはありません。 (ただし、同じフィルタを使ってユーザー独自のアプリケーション論理を導く場合は、ユーザー・コードから直接呼び出すことも可能。)- パラメータ:
n
- フィルタを通過するかどうかをチェックするノード。- 戻り値:
- 前述のように、ノードの受け入れ、拒否、またはスキップを判定する定数。
-
-