模块  java.xml
软件包  org.w3c.dom.ls

Interface LSSerializerFilter

  • All Superinterfaces:
    NodeFilter 
    public interface LSSerializerFilter
extends NodeFilter
    LSSerializerFilter s为应用程序提供了在序列化时检查节点并决定应该序列化哪些节点的能力。 LSSerializerFilter接口基于[ DOM Level 2 Traversal and Range ]中定义的NodeFilter接口。

    Document ， DocumentType ， DocumentFragment ， Notation ， Entity ，和孩子Attr节点不会传递给过滤器。 一个的子节点EntityReference节点只传递给过滤器如果EntityReference节点由该方法跳过LSParserFilter.acceptNode() 。

    序列化Element ，元素将在其任何属性传递给过滤器之前传递给过滤器。 名称空间声明属性和默认属性（“discard-default-content”设置为false ）永远不会传递给过滤器。

    任何尝试修改传递给LSSerializerFilter的节点的LSSerializerFilter都取决于实现。

    DOM应用程序不得在过滤器中引发异常。 从过滤器抛出异常的效果取决于DOM实现。

    为了提高效率，传递给过滤器的节点可能与树中实际的节点不同。 并且在过滤和序列化文档的过程中可以重用实际节点（节点对象标识）。

    另见Document Object Model (DOM) Level 3 Load and Save Specification 。

    从以下版本开始：
    1.5

    • 方法详细信息

      • getWhatToShow

        int getWhatToShow()
        告诉LSSerializer过滤器显示哪些类型的节点。 如果使用此属性未向筛选器显示节点，则会自动序列化该节点。 有关NodeFilter的定义，请参见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 ]中定义。