ParserAdapter

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 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
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)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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