站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

ParserAdapter (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

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 Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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