JavaTM 2 Platform
Standard Ed. 5.0

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)

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策