org.xml.sax.helpers
类 ParserAdapter

java.lang.Object
  org.xml.sax.helpers.ParserAdapter

所有已实现的接口：

DocumentHandler, XMLReader

public class ParserAdapter
extends Object
implements XMLReader, DocumentHandler

将 SAX1 Parser 适配为 SAX2 XMLReader。

此模块（包括源代码和文档）位于公共域中，对该模块不提供担保。有关更多信息，请参阅http://www.saxproject.org。

此类包装 SAX1 Parser，并使其充当带有功能、属性和名称空间支持的 SAX2 XMLReader。注意，不可能报告 skippedEntity 事件，因为 SAX1 不提供该信息。

此适配器不对重复的名称空间限定的属性进行测试。

从以下版本开始：

SAX 2.0

另请参见：

XMLReaderAdapter, XMLReader, Parser

构造方法摘要

ParserAdapter()
构造一个新解析器适配器。

ParserAdapter(Parser parser)
构造一个新的解析器适配器。

方法摘要

void	characters(char[] ch, int start, int length) 适配器实现方法；不调用。
void	endDocument() 适配器实现方法；不调用。
void	endElement(String qName) 适配器实现方法；不调用。
ContentHandler	getContentHandler() 返回当前内容处理程序。
DTDHandler	getDTDHandler() 返回当前 DTD 处理程序。
EntityResolver	getEntityResolver() 返回当前实体解析器。
ErrorHandler	getErrorHandler() 返回当前错误处理程序。
boolean	getFeature(String name) 检查解析器功能标志。
Object	getProperty(String name) 获取解析器属性。
void	ignorableWhitespace(char[] ch, int start, int length) 适配器实现方法；不调用。
void	parse(InputSource input) 解析 XML 文档。
void	parse(String systemId) 解析 XML 文档。
void	processingInstruction(String target, String data) 适配器实现方法；不调用。
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	setProperty(String name, Object value) 设置解析器属性。
void	startDocument() 适配器实现方法；不调用。
void	startElement(String qName, AttributeList qAtts) 适配器实现方法；不调用。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

ParserAdapter

public ParserAdapter()
              throws SAXException

构造一个新解析器适配器。

使用 "org.xml.sax.parser" 属性查找嵌入的 SAX1 驱动程序。

抛出：

SAXException - 如果不能实例化嵌入的驱动程序，或者未指定 org.xml.sax.parser 属性。

ParserAdapter

public ParserAdapter(Parser parser)

构造一个新的解析器适配器。

注意，一旦创建适配器，将不能更改嵌入的解析器；要嵌入不同的解析器，应分配一个新的 ParserAdapter。

参数：

parser - 要嵌入的 SAX1 解析器。

抛出：

NullPointerException - 如果解析器参数为 null。

方法详细信息

setFeature

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

为解析器设置功能标志。

能识别的功能仅为名称空间和名称前缀。

指定者：

接口 XMLReader 中的 setFeature

参数：

name - 功能名称，作为一个完整的 URI。

value - 请求的功能值。

抛出：

SAXNotRecognizedException - 如果无法分配或检索该功能。

SAXNotSupportedException - 如果不能把该值分配给功能。

另请参见：

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

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

检查解析器功能标志。

能识别的功能仅为名称空间和名称前缀。

指定者：

接口 XMLReader 中的 getFeature

参数：

name - 功能名称，作为一个完整的 URI。

返回：

当前功能值。

抛出：

SAXNotRecognizedException - 如果无法分配或检索功能值。

SAXNotSupportedException - 如果该功能当前不可读。

另请参见：

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

setProperty

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

设置解析器属性。

当前未识别任何属性。

指定者：

接口 XMLReader 中的 setProperty

参数：

name - 属性名。

value - 属性值。

抛出：

SAXNotRecognizedException - 如果无法分配或检索属性值。

SAXNotSupportedException - 如果不能把该值分配给属性。

另请参见：

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

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

获取解析器属性。

当前未识别任何属性。

指定者：

接口 XMLReader 中的 getProperty

参数：

name - 属性名。

返回：

属性值。

抛出：

SAXNotRecognizedException - 如果无法分配或检索属性值。

SAXNotSupportedException - 如果属性值当前不可读。

另请参见：

XMLReader.getProperty(java.lang.String)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

设置实体解析器。

指定者：

接口 XMLReader 中的 setEntityResolver

参数：

resolver - 新实体解析器。

另请参见：

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

getEntityResolver

public EntityResolver getEntityResolver()

返回当前实体解析器。

指定者：

接口 XMLReader 中的 getEntityResolver

返回：

当前实体解析器，如果未提供，则返回 null。

另请参见：

XMLReader.getEntityResolver()

setDTDHandler

public void setDTDHandler(DTDHandler handler)

设置 DTD 处理程序。

指定者：

接口 XMLReader 中的 setDTDHandler

参数：

handler - the new DTD handler

另请参见：

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

getDTDHandler

public DTDHandler getDTDHandler()

返回当前 DTD 处理程序。

指定者：

接口 XMLReader 中的 getDTDHandler

返回：

当前 DTD 处理程序，如果未提供，则返回 null

另请参见：

XMLReader.getEntityResolver()

setContentHandler

public void setContentHandler(ContentHandler handler)

设置内容处理程序。

指定者：

接口 XMLReader 中的 setContentHandler

参数：

handler - the new content handler

另请参见：

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

getContentHandler

public ContentHandler getContentHandler()

返回当前内容处理程序。

指定者：

接口 XMLReader 中的 getContentHandler

返回：

当前内容处理程序，如果未提供，则返回 null。

另请参见：

XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

设置错误处理程序。

指定者：

接口 XMLReader 中的 setErrorHandler

参数：

handler - 新的错误处理程序。

另请参见：

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

getErrorHandler

public ErrorHandler getErrorHandler()

返回当前错误处理程序。

指定者：

接口 XMLReader 中的 getErrorHandler

返回：

当前错误处理程序，如果未提供，则返回 null。

另请参见：

XMLReader.getEntityResolver()

parse

public void parse(String systemId)
           throws IOException,
                  SAXException

解析 XML 文档。

指定者：

接口 XMLReader 中的 parse

参数：

systemId - 文档的绝对 URL。

抛出：

IOException - 如果在读取文档的原始内容时存在问题。

SAXException - 如果在处理文档时存在问题。

另请参见：

parse(org.xml.sax.InputSource), Parser.parse(java.lang.String)

parse

public void parse(InputSource input)
           throws IOException,
                  SAXException

解析 XML 文档。

指定者：

接口 XMLReader 中的 parse

参数：

input - 文档的输入源。

抛出：

IOException - 如果在读取文档的原始内容时存在问题。

SAXException - 如果在处理文档时存在问题。

另请参见：

parse(java.lang.String), Parser.parse(org.xml.sax.InputSource)

setDocumentLocator

public void setDocumentLocator(Locator locator)

适配器实现方法；不调用。适配 SAX1 文档定位器事件。

指定者：

接口 DocumentHandler 中的 setDocumentLocator

参数：

locator - 文档定位器。

另请参见：

ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument()
                   throws SAXException

适配器实现方法；不调用。适配 SAX1 开始文档事件。

指定者：

接口 DocumentHandler 中的 startDocument

抛出：

SAXException - 客户端可能引发处理异常。

另请参见：

DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException

适配器实现方法；不调用。适配 SAX1 结束文档事件。

指定者：

接口 DocumentHandler 中的 endDocument

抛出：

SAXException - 客户端可能引发处理异常。

另请参见：

DocumentHandler.endDocument()

startElement

public void startElement(String qName,
                         AttributeList qAtts)
                  throws SAXException

适配器实现方法；不调用。适配 SAX1 startElement 事件。

如果必要，则执行 Namespace 处理。

指定者：

接口 DocumentHandler 中的 startElement

参数：

qName - 限定的（前缀）名称。

qAtts - XML 属性列表（带 qnames）。

抛出：

SAXException - 客户端可能引发处理异常。

另请参见：

DocumentHandler.endElement(java.lang.String), AttributeList

endElement

public void endElement(String qName)
                throws SAXException

适配器实现方法；不调用。适配 SAX1 结束元素事件。

指定者：

接口 DocumentHandler 中的 endElement

参数：

qName - 限定的（前缀）名称。

抛出：

SAXException - 客户端可能引发处理异常。

另请参见：

DocumentHandler.endElement(java.lang.String)

characters

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

适配器实现方法；不调用。适配 SAX1 字符事件。

指定者：

接口 DocumentHandler 中的 characters

参数：

ch - 一个字符数组。

start - 数组中的开始位置。

length - 要使用的字符数。

抛出：

SAXException - 客户端可能引发处理异常。

另请参见：

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

ignorableWhitespace

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

适配器实现方法；不调用。适配 SAX1 可忽略空白事件。

指定者：

接口 DocumentHandler 中的 ignorableWhitespace

参数：

ch - 字符数组。

start - 数组中的开始位置。

length - 要使用的字符数。

抛出：

SAXException - 客户端可能引发处理异常。

另请参见：

DocumentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

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

适配器实现方法；不调用。适配 SAX1 处理指令事件。

指定者：

接口 DocumentHandler 中的 processingInstruction

参数：

target - 处理指令目标。

data - 处理指令的剩余部分

抛出：

SAXException - 客户端可能引发处理异常。

另请参见：

DocumentHandler.processingInstruction(java.lang.String, java.lang.String)