- 既知のすべてのサブインタフェース:
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 final short
ノードを受け入れます。static final short
ノードを拒否します。static final short
指定した単一のノードをスキップします。static final int
すべてのNodes
を示します。static final int
Attr
ノードを示します。static final int
CDATASection
ノードを示します。static final int
Comment
ノードを示します。static final int
Document
ノードを示します。static final int
DocumentFragment
ノードを示します。static final int
DocumentType
ノードを示します。static final int
Element
ノードを示します。static final int
Entity
ノードを示します。static final int
EntityReference
ノードを示します。static final int
Notation
ノードを示します。static final int
ProcessingInstruction
ノードを示します。static final int
Text
ノードを示します。 -
メソッドのサマリー
-
フィールド詳細
-
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_ELEMENTElement
ノードを示します。- 関連項目:
-
SHOW_ATTRIBUTE
static final int SHOW_ATTRIBUTEAttr
ノードを示します。 このフィールドは、属性ノードをroot
とするNodeIterator
またはTreeWalker
を生成するときにのみ有効です。この場合、属性ノードが反復処理またはトラバーサルの最初の位置に現れることを示します。 属性は、他のノードの子であることはないので、ドキュメント・ツリー上をトラバースするときに現れません。- 関連項目:
-
SHOW_TEXT
static final int SHOW_TEXTText
ノードを示します。- 関連項目:
-
SHOW_CDATA_SECTION
static final int SHOW_CDATA_SECTIONCDATASection
ノードを示します。- 関連項目:
-
SHOW_ENTITY_REFERENCE
static final int SHOW_ENTITY_REFERENCEEntityReference
ノードを示します。- 関連項目:
-
SHOW_ENTITY
static final int SHOW_ENTITYEntity
ノードを示します。 このフィールドは、Entity
ノードをroot
とするNodeIterator
またはTreeWalker
を生成するときにのみ有効です。この場合、Entity
ノードがトラバーサルの最初の位置に現れることを示します。 エンティティは、ドキュメント・ツリーの一部ではないので、ドキュメント・ツリー上をトラバースするときに現れません。- 関連項目:
-
SHOW_PROCESSING_INSTRUCTION
static final int SHOW_PROCESSING_INSTRUCTIONProcessingInstruction
ノードを示します。- 関連項目:
-
SHOW_COMMENT
static final int SHOW_COMMENTComment
ノードを示します。- 関連項目:
-
SHOW_DOCUMENT
static final int SHOW_DOCUMENTDocument
ノードを示します。- 関連項目:
-
SHOW_DOCUMENT_TYPE
static final int SHOW_DOCUMENT_TYPEDocumentType
ノードを示します。- 関連項目:
-
SHOW_DOCUMENT_FRAGMENT
static final int SHOW_DOCUMENT_FRAGMENTDocumentFragment
ノードを示します。- 関連項目:
-
SHOW_NOTATION
static final int SHOW_NOTATIONNotation
ノードを示します。 このフィールドは、Notation
ノードをroot
とするNodeIterator
またはTreeWalker
を生成するときにのみ有効です。この場合、Notation
ノードがトラバーサルの最初の位置に現れることを示します。 表記法は、ドキュメント・ツリーの一部ではないので、ドキュメント・ツリー上をトラバースするときに現れません。- 関連項目:
-
-
メソッドの詳細
-
acceptNode
short acceptNode(Node n) 指定されたノードがTreeWalker
またはNodeIterator
の論理ビューで可視であるかどうかをテストします。 この関数は、TreeWalker
とNodeIterator
の実装により呼び出され、通常はユーザー・コードから直接呼び出されることはありません。 (ただし、同じフィルタを使ってユーザー独自のアプリケーション論理を導く場合は、ユーザー・コードから直接呼び出すことも可能。)- パラメータ:
n
- フィルタを通過するかどうかをチェックするノード。- 戻り値:
- 前述のように、ノードの受け入れ、拒否、またはスキップを判定する定数。
-