compact2, compact3

org.xml.sax.helpers

Class XMLFilterImpl

java.lang.Object

org.xml.sax.helpers.XMLFilterImpl

All Implemented Interfaces:

ContentHandler， DTDHandler， EntityResolver， ErrorHandler， XMLFilter， XMLReader

public class XMLFilterImpl
extends Object
implements XMLFilter, EntityResolver, DTDHandler, ContentHandler, ErrorHandler

导出XML筛选器的基类。

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.

这类设计在XMLReader和客户端应用程序的事件处理程序之间。默认情况下，它只会传递请求到阅读器和事件上的处理程序未修改，但子类可以重写特定的方法来修改事件流或配置请求，因为它们通过。

从以下版本开始：

萨克斯2

另请参见：

XMLFilter， XMLReader， EntityResolver， DTDHandler， ContentHandler， ErrorHandler

构造方法摘要

构造方法

Constructor and Description
XMLFilterImpl() 构建一个空的XML筛选器，没有父类。
XMLFilterImpl(XMLReader parent) 用指定的父项构造一个XML筛选器。

方法摘要

Modifier and Type	Method and Description
void	characters(char[] ch, int start, int length) 筛选字符数据事件。
void	endDocument() 过滤结束文档事件。
void	endElement(String uri, String localName, String qName) 过滤结束元素事件。
void	endPrefixMapping(String prefix) 过滤结束命名空间前缀映射事件。
void	error(SAXParseException e) 筛选错误事件。
void	fatalError(SAXParseException e) 过滤一个致命错误事件。
ContentHandler	getContentHandler() 获取内容事件处理程序。
DTDHandler	getDTDHandler() 获取当前文档的事件处理程序。
EntityResolver	getEntityResolver() 获取当前实体解析器。
ErrorHandler	getErrorHandler() 获取当前错误事件处理程序。
boolean	getFeature(String name) 查找一个特征的值。
XMLReader	getParent() 获取父阅读器。
Object	getProperty(String name) 查找属性的值。
void	ignorableWhitespace(char[] ch, int start, int length) 过滤器可忽略空白的事件。
void	notationDecl(String name, String publicId, String systemId) 筛选符号声明事件。
void	parse(InputSource input) 解析文档。
void	parse(String systemId) 解析文档。
void	processingInstruction(String target, String data) 筛选处理指令事件。
InputSource	resolveEntity(String publicId, String systemId) 过滤外部实体分辨率。
void	setContentHandler(ContentHandler handler) 设置内容事件处理程序。
void	setDocumentLocator(Locator locator) 过滤一个新的文档定位事件。
void	setDTDHandler(DTDHandler handler) 设置DTD事件处理程序。
void	setEntityResolver(EntityResolver resolver) 将实体分解器。
void	setErrorHandler(ErrorHandler handler) 设置错误事件处理程序。
void	setFeature(String name, boolean value) 设置一个功能的值。
void	setParent(XMLReader parent) 设置父阅读器。
void	setProperty(String name, Object value) 设置属性的值。
void	skippedEntity(String name) 跳过一个跳过的实体事件。
void	startDocument() 筛选启动文档事件。
void	startElement(String uri, String localName, String qName, Attributes atts) 筛选启动元素事件。
void	startPrefixMapping(String prefix, String uri) 过滤启动命名空间前缀映射事件。
void	unparsedEntityDecl(String name, String publicId, String systemId, String notationName) 过滤器未分析实体声明事件。
void	warning(SAXParseException e) 筛选警告事件。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XMLFilterImpl

public XMLFilterImpl()

构建一个空的XML筛选器，没有父类。

此过滤器将没有家长：你必须指定一个家长在你开始解析或setfeature或设置做任何配置，除非你使用这个作为一个纯粹的事件消费者而不是作为一个XMLReader。

另请参见：

XMLReader.setFeature(java.lang.String, boolean)， XMLReader.setProperty(java.lang.String, java.lang.Object)， setParent(org.xml.sax.XMLReader)

XMLFilterImpl

public XMLFilterImpl(XMLReader parent)

用指定的父项构造一个XML筛选器。

另请参见：

setParent(org.xml.sax.XMLReader)， getParent()

方法详细信息

setParent

public void setParent(XMLReader parent)

设置父阅读器。

这是XMLReader此过滤器将获得它的事件，它会通过它的配置要求。父可能本身是另一个过滤器。

如果没有父阅读器设置，任何试图解析或设置或得到一个功能或属性将失败。

Specified by:

setParent 接口 XMLFilter

参数

parent -母XML读取器。

另请参见：

getParent()

getParent

public XMLReader getParent()

获取父阅读器。

Specified by:

getParent 接口 XMLFilter

结果

父xml阅读器，或null，如果没有设置。

另请参见：

setParent(org.xml.sax.XMLReader)

setFeature

public void setFeature(String name,
                       boolean value)
                throws SAXNotRecognizedException,
                       SAXNotSupportedException

设置一个功能的值。

如果父是空的，则会失败。

Specified by:

setFeature 接口 XMLReader

参数

name -功能名称。

所要求的特征值 value -。

异常

SAXNotRecognizedException -如果特征值不能被分配或从母体取出。

SAXNotSupportedException -当家长识别特征的名字但不能设置请求的值。

另请参见：

XMLReader.getFeature(java.lang.String)

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

查找一个特征的值。

如果父是空的，则会失败。

Specified by:

getFeature 接口 XMLReader

参数

name -功能名称。

结果

特征的当前值。

异常

SAXNotRecognizedException -如果特征值不能被分配或从母体取出。

SAXNotSupportedException -当家长识别特征的名字但不能确定它的价值在这个时候。

另请参见：

XMLReader.setFeature(java.lang.String, boolean)

setProperty

public void setProperty(String name,
                        Object value)
                 throws SAXNotRecognizedException,
                        SAXNotSupportedException

设置属性的值。

如果父是空的，则会失败。

Specified by:

setProperty 接口 XMLReader

参数

name -属性名称。

value -要求的属性值。

异常

SAXNotRecognizedException -如果属性值不能被分配或从母体取出。

SAXNotSupportedException -当家长认识到属性名称，但不能设置请求的值。

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

查找属性的值。

Specified by:

getProperty 接口 XMLReader

参数

name -属性名称。

结果

属性的当前值。

异常

SAXNotRecognizedException -如果属性值不能被分配或从母体取出。

SAXNotSupportedException -当家长认识到属性名称，但不能确定它的价值在这个时候。

另请参见：

XMLReader.setProperty(java.lang.String, java.lang.Object)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

将实体分解器。

Specified by:

setEntityResolver 接口 XMLReader

参数

resolver -新实体解析器。

另请参见：

XMLReader.getEntityResolver()

getEntityResolver

public EntityResolver getEntityResolver()

获取当前实体解析器。

Specified by:

getEntityResolver 接口 XMLReader

结果

当前实体解析器，或空如果没有设置。

另请参见：

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

setDTDHandler

public void setDTDHandler(DTDHandler handler)

设置DTD事件处理程序。

Specified by:

setDTDHandler 接口 XMLReader

参数

handler -新的DTD处理程序

另请参见：

XMLReader.getDTDHandler()

getDTDHandler

public DTDHandler getDTDHandler()

获取当前文档的事件处理程序。

Specified by:

getDTDHandler 接口 XMLReader

结果

目前的DTD处理，或空如果没有设置。

另请参见：

XMLReader.setDTDHandler(org.xml.sax.DTDHandler)

setContentHandler

public void setContentHandler(ContentHandler handler)

设置内容事件处理程序。

Specified by:

setContentHandler 接口 XMLReader

参数

handler -新的内容处理程序

另请参见：

XMLReader.getContentHandler()

getContentHandler

public ContentHandler getContentHandler()

获取内容事件处理程序。

Specified by:

getContentHandler 接口 XMLReader

结果

当前的内容处理程序，或为空，如果没有设置。

另请参见：

XMLReader.setContentHandler(org.xml.sax.ContentHandler)

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

设置错误事件处理程序。

Specified by:

setErrorHandler 接口 XMLReader

参数

handler -新的错误处理程序

另请参见：

XMLReader.getErrorHandler()

getErrorHandler

public ErrorHandler getErrorHandler()

获取当前错误事件处理程序。

Specified by:

getErrorHandler 接口 XMLReader

结果

当前的错误处理程序，或为空，如果没有设置。

另请参见：

XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)

parse

public void parse(InputSource input)
           throws SAXException,
                  IOException

解析文档。

Specified by:

parse 接口 XMLReader

参数

input -文档实体的输入源。

异常

SAXException -萨克斯例外，可能是包装的另一个例外。

IOException -从解析器的IO异常，可能从一个字节流和字符流的应用程序提供的。

另请参见：

InputSource， XMLReader.parse(java.lang.String)， XMLReader.setEntityResolver(org.xml.sax.EntityResolver)， XMLReader.setDTDHandler(org.xml.sax.DTDHandler)， XMLReader.setContentHandler(org.xml.sax.ContentHandler)， XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)

parse

public void parse(String systemId)
           throws SAXException,
                  IOException

解析文档。

Specified by:

parse 接口 XMLReader

参数

systemId -作为一个完全合格的URI标识系统。

异常

SAXException -萨克斯例外，可能是包装的另一个例外。

IOException -从解析器的IO异常，可能从一个字节流和字符流的应用程序提供的。

另请参见：

XMLReader.parse(org.xml.sax.InputSource)

resolveEntity

public InputSource resolveEntity(String publicId,
                                 String systemId)
                          throws SAXException,
                                 IOException

过滤外部实体分辨率。

Specified by:

resolveEntity 接口 EntityResolver

参数

publicId -实体的公共标识符，或空。

systemId -实体的系统标识符。

结果

对于默认的新inputsource或空。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

IOException -客户可以抛出一个I/O相关的例外而获得新的inputsource。

另请参见：

InputSource

notationDecl

public void notationDecl(String name,
                         String publicId,
                         String systemId)
                  throws SAXException

筛选符号声明事件。

Specified by:

notationDecl 接口 DTDHandler

参数

name -符号名称。

publicId -符号的公共标识符，或空。

systemId -符号的系统标识符，或空。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)， Attributes

unparsedEntityDecl

public void unparsedEntityDecl(String name,
                               String publicId,
                               String systemId,
                               String notationName)
                        throws SAXException

过滤器未分析实体声明事件。

Specified by:

unparsedEntityDecl 接口 DTDHandler

参数

name -实体名称。

publicId -实体的公共标识符，或空。

systemId -实体的系统标识符，或空。

notationName -相关的符号名称。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)， Attributes

setDocumentLocator

public void setDocumentLocator(Locator locator)

过滤一个新的文档定位事件。

Specified by:

setDocumentLocator 接口 ContentHandler

参数

locator -文件定位器。

另请参见：

Locator

startDocument

public void startDocument()
                   throws SAXException

筛选启动文档事件。

Specified by:

startDocument 接口 ContentHandler

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

ContentHandler.endDocument()

endDocument

public void endDocument()
                 throws SAXException

过滤结束文档事件。

Specified by:

endDocument 接口 ContentHandler

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

ContentHandler.startDocument()

startPrefixMapping

public void startPrefixMapping(String prefix,
                               String uri)
                        throws SAXException

过滤启动命名空间前缀映射事件。

Specified by:

startPrefixMapping 接口 ContentHandler

参数

prefix -命名空间前缀。

uri的命名空间URI。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

ContentHandler.endPrefixMapping(java.lang.String)， ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)

endPrefixMapping

public void endPrefixMapping(String prefix)
                      throws SAXException

过滤结束命名空间前缀映射事件。

Specified by:

endPrefixMapping 接口 ContentHandler

参数

prefix -命名空间前缀。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)， ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

startElement

public void startElement(String uri,
                         String localName,
                         String qName,
                         Attributes atts)
                  throws SAXException

筛选启动元素事件。

Specified by:

startElement 接口 ContentHandler

参数

uri -元素的命名空间URI或空字符串。

localName -元素的本地名称，或空字符串。

qName -元素的合格（前缀）的名字，或空字符串。

atts -元素的属性。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)， Attributes， AttributesImpl

endElement

public void endElement(String uri,
                       String localName,
                       String qName)
                throws SAXException

过滤结束元素事件。

Specified by:

endElement 接口 ContentHandler

参数

uri -元素的命名空间URI或空字符串。

localName -元素的本地名称，或空字符串。

qName -元素的合格（前缀）的名字，或空字符串。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws SAXException

筛选字符数据事件。

Specified by:

characters 接口 ContentHandler

参数

ch -一个字符数组。

start -数组中的起始位置。

length -字符数使用数组。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

ContentHandler.ignorableWhitespace(char[], int, int)， Locator

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws SAXException

过滤器可忽略空白的事件。

Specified by:

ignorableWhitespace 接口 ContentHandler

参数

ch -一个字符数组。

start -数组中的起始位置。

length -字符数使用数组。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

ContentHandler.characters(char[], int, int)

processingInstruction

public void processingInstruction(String target,
                                  String data)
                           throws SAXException

筛选处理指令事件。

Specified by:

processingInstruction 接口 ContentHandler

参数

target -处理指令的目标。

data跟踪目标文本。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

skippedEntity

public void skippedEntity(String name)
                   throws SAXException

跳过一个跳过的实体事件。

Specified by:

skippedEntity 接口 ContentHandler

参数

name -跳过的实体的名称。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

warning

public void warning(SAXParseException e)
             throws SAXException

筛选警告事件。

Specified by:

warning 接口 ErrorHandler

参数

e -警告作为例外。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

SAXParseException

error

public void error(SAXParseException e)
           throws SAXException

筛选错误事件。

Specified by:

error 接口 ErrorHandler

参数

e -误差作为例外。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

SAXParseException

fatalError

public void fatalError(SAXParseException e)
                throws SAXException

过滤一个致命错误事件。

Specified by:

fatalError 接口 ErrorHandler

参数

e -误差作为例外。

异常

SAXException -客户端可能会抛出一个异常处理过程中。

另请参见：

SAXParseException