所有类


org.xml.sax.helpers
类 XMLReaderAdapter

java.lang.Object
  继承者 org.xml.sax.helpers.XMLReaderAdapter
所有已实现的接口:
ContentHandler, Parser

public class XMLReaderAdapter
   
   
   
   
     
     
extends Object
implements Parser, ContentHandler

将 SAX2 XMLReader 适配为 SAX1 解析器。

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

此类包装 SAX2 XMLReader 并且使之充当 SAX1 Parser。XMLReader 必须支持 http://xml.org/sax/features/namespace-prefixes 属性的 true 值,否则解析将会失败,并抛出 SAXException;如果 XMLReader 支持 http://xml.org/sax/features/namespaces 属性的 false 值,这也将会被用于提高效率。

从以下版本开始:
SAX 2.0
另请参见:
Parser, XMLReader

构造方法摘要
XMLReaderAdapter()
          创建一个新的适配器。
XMLReaderAdapter(XMLReader xmlReader)
          创建一个新的适配器。
 
方法摘要
 voidcharacters(char[] ch, int start, int length)
          适配 SAX2 字符事件。
 voidendDocument()
          结束文档事件。
 voidendElement(String uri, String localName, String qName)
          适配 SAX2 结束元素事件。
 voidendPrefixMapping(String prefix)
          适配 SAX2 结束前缀映射事件。
 voidignorableWhitespace(char[] ch, int start, int length)
          适配 SAX2 忽略空白事件。
 voidparse(InputSource input)
          解析文档。
 voidparse(String systemId)
          解析文档。
 voidprocessingInstruction(String target, String data)
          适配 SAX2 处理指令事件。
 voidsetDocumentHandler(DocumentHandler handler)
          注册 SAX1 文档事件处理程序。
 voidsetDocumentLocator(Locator locator)
          设置文档定位器。
 voidsetDTDHandler(DTDHandler handler)
          注册 DTD 事件处理程序。
 voidsetEntityResolver(EntityResolver resolver)
          注册实体解析器。
 voidsetErrorHandler(ErrorHandler handler)
          注册错误事件处理程序。
 voidsetLocale(Locale locale)
          设置错误报告的语言环境。
 voidskippedEntity(String name)
          适配 SAX2 跳过的实体事件。
 voidstartDocument()
          开始文档事件。
 voidstartElement(String uri, String localName, String qName, Attributes atts)
          适配 SAX2 开始元素事件。
 voidstartPrefixMapping(String prefix, String uri)
          适配 SAX2 开始前缀映射事件。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

XMLReaderAdapter

public XMLReaderAdapter()
                 throws SAXException
创建一个新的适配器。

使用 "org.xml.sax.driver" 属性来查找要嵌入的 SAX2 驱动程序。

抛出:
SAXException - 如果无法实例化嵌入的驱动程序,或者未指定 org.xml.sax.driver 属性。

XMLReaderAdapter

public XMLReaderAdapter(XMLReader xmlReader)
创建一个新的适配器。

创建一个新的适配器,包装 SAX2 XMLReader。适配器将使 XMLReader 的作用与 SAX1 解析器类似。

参数:
xmlReader - 要包装的 SAX2 XMLReader。
抛出:
NullPointerException - 如果参数为 null。
方法详细信息

setLocale

public void setLocale(Locale locale)
               throws SAXException
设置错误报告的语言环境。

SAX2 中不支持这么做,并且总是抛出异常。

指定者:
接口 Parser 中的 setLocale
参数:
locale - 错误报告的语言环境。
抛出:
SAXException - 如果不重写则抛出该异常。
另请参见:
Parser.setLocale(java.util.Locale)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)
注册实体解析器。

指定者:
接口 Parser 中的 setEntityResolver
参数:
resolver - 新的解析器。
另请参见:
Parser.setEntityResolver(org.xml.sax.EntityResolver)

setDTDHandler

public void setDTDHandler(DTDHandler handler)
注册 DTD 事件处理程序。

指定者:
接口 Parser 中的 setDTDHandler
参数:
handler - 新的 DTD 事件处理程序。
另请参见:
Parser.setDTDHandler(org.xml.sax.DTDHandler)

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)
注册 SAX1 文档事件处理程序。

注意,SAX1 文档处理程序不支持名称空间。

指定者:
接口 Parser 中的 setDocumentHandler
参数:
handler - 新的 SAX1 文档事件处理程序。
另请参见:
Parser.setDocumentHandler(org.xml.sax.DocumentHandler)

setErrorHandler

public void setErrorHandler(ErrorHandler handler)
注册错误事件处理程序。

指定者:
接口 Parser 中的 setErrorHandler
参数:
handler - 新的错误事件处理程序。
另请参见:
Parser.setErrorHandler(org.xml.sax.ErrorHandler)

parse

public void parse(String systemId)
           throws IOException,
                  SAXException
解析文档。

如果嵌入的 XMLReader 不支持 http://xml.org/sax/features/namespace-prefixes 属性,此方法将抛出异常。

指定者:
接口 Parser 中的 parse
参数:
systemId - 文档的绝对 URL。
抛出:
IOException - 如果在读取文档的原始内容时存在问题。
SAXException - 如果在处理文档时存在问题。
另请参见:
parse(org.xml.sax.InputSource), Parser.parse(java.lang.String)