public interface LSSerializerFilter
LSSerializerFilter
为应用程序提供了在序列化节点时检查节点以及决定哪些节点应该或不应该序列化的能力。LSSerializerFilter
接口基于 [DOM Level 2 Traversal and Range] 中定义的 NodeFilter
接口。
Document
、DocumentType
、DocumentFragment
、Notation
、Entity
和 Attr
节点的子节点不传递给过滤器。如果通过方法 LSParserFilter.acceptNode()
跳过 EntityReference
节点,则仅将 EntityReference
节点的子节点传递给过滤器。
当序列化 Element
时,在将它的所有属性传递给过滤器前将该元素传递给过滤器。从不将名称空间声明属性和默认属性(除了在 " discard-default-content" 设置为 false
时)传递给过滤器。
任何尝试修改传递给 LSSerializerFilter
的节点的结果都将具有实现依赖性。
DOM 应用程序不能引发过滤器中的异常。从过滤器中抛出异常的效果具有 DOM 实现依赖性。
为了提高效率,传递给过滤器的节点不能与实际在树中的节点相同。并且实际的节点(节点对象标识)可以在文档过滤和序列化期间重新使用。
另请参见《Document Object Model (DOM) Level 3 Load and Save Specification》。
字段摘要 |
---|
从接口 org.w3c.dom.traversal.NodeFilter 继承的字段 |
---|
FILTER_ACCEPT, FILTER_REJECT, FILTER_SKIP, SHOW_ALL, SHOW_ATTRIBUTE, SHOW_CDATA_SECTION, SHOW_COMMENT, SHOW_DOCUMENT, SHOW_DOCUMENT_FRAGMENT, SHOW_DOCUMENT_TYPE, SHOW_ELEMENT, SHOW_ENTITY, SHOW_ENTITY_REFERENCE, SHOW_NOTATION, SHOW_PROCESSING_INSTRUCTION, SHOW_TEXT |
方法摘要 | |
---|---|
int |
getWhatToShow() 告诉 LSSerializer 向过滤器显示什么类型的节点。 |
从接口 org.w3c.dom.traversal.NodeFilter 继承的方法 |
---|
acceptNode |
方法详细信息 |
---|
int getWhatToShow()
LSSerializer
向过滤器显示什么类型的节点。如果未将节点显示给使用此属性的过滤器,则将自动序列化。有关对常量的定义请参见
NodeFilter
。常量
SHOW_DOCUMENT
、
SHOW_DOCUMENT_TYPE
、
SHOW_DOCUMENT_FRAGMENT
、
SHOW_NOTATION
和
SHOW_ENTITY
在此无意义,从不会将此类节点传递给
LSSerializerFilter
。
SHOW_ATTRIBUTE
常量表示显示
Attr
节点并将它传递给过滤器。