インタフェースLSSerializerFilter

すべてのスーパー・インタフェース:
NodeFilter
public interface LSSerializerFilter extends NodeFilter
LSSerializerFilterを使用すると、アプリケーションでは、ノードが直列化されるときにノードを検証し、どのノードを直列化する必要があるかを判定できます。 LSSerializerFilterインタフェースは、「DOM Level 2 Traversal and Range」で定義されているNodeFilterインタフェースに基づいています。

Document、DocumentType、DocumentFragment、Notation、Entityと、Attrノードの子は、フィルタには渡されません。 EntityReferenceノードがLSParserFilter.acceptNode()メソッドによってスキップされた場合は、EntityReferenceノードの子ノードだけがフィルタに渡されます。

Elementの直列化時、要素は、そのどの属性がフィルタに渡されるよりも前にフィルタに渡されます。 名前空間宣言属性およびデフォルト属性(「discard-default-content」がfalseに設定されている場合を除く)がフィルタに渡されることはありません。

LSSerializerFilterに渡されるノードを変更しようとするどのような試みの結果も実装に依存します。

DOMアプリケーションがフィルタの例外をスローすることはありません。 フィルタから例外がスローされる場合、その影響はDOM実装によって異なります。

効率性のために、フィルタに渡されるノードは実際にツリーに存在するノードと同じものではない可能性があります。 実際のノード(ノード・オブジェクト・アイデンティティ)は、文書をフィルタ処理し、直列化する間に再利用される可能性があります。

「Document Object Model (DOM) Level 3 Load and Save Specification」も参照してください。

導入されたバージョン:
1.5

  • メソッドの詳細

    • getWhatToShow

      int getWhatToShow()
      フィルタに対してどのタイプのノードを示すかをLSSerializerに通知します。 ノードが、この属性を使用するフィルタに示されない場合、自動的に直列化されます。 定数の定義についてはNodeFilterを参照してください。 定数SHOW_DOCUMENT、SHOW_DOCUMENT_TYPE、SHOW_DOCUMENT_FRAGMENT、SHOW_NOTATIONおよびSHOW_ENTITYは、ここでは意味がありません。このようなノードがLSSerializerFilterに渡されることはありません。
      「DOM Level 2 Traversal and Range」とは異なり、SHOW_ATTRIBUTE定数は、Attrノードが表示され、フィルタに渡されることを示します。
      ここで使用されている定数は、「DOM Level 2 Traversal and Range」で定義されています。