Module java.xml

Package org.xml.sax.helpers

Class XMLReaderAdapter

java.lang.Object

org.xml.sax.helpers.XMLReaderAdapter

所有已实现的接口:

ContentHandler, Parser

       public class XMLReaderAdapter extends Object implements Parser, ContentHandler
      

将SAX2 XMLReader适配为SAX1解析器。

这个类包装了一个SAX2 XMLReader，使其充当SAX1 Parser。XMLReader必须支持http://xml.org/sax/features/namespace-prefixes属性的真值，否则解析将失败并抛出一个SAXException；如果XMLReader支持http://xml.org/sax/features/namespaces属性的假值，那也将用于提高效率。

自从:

1.4, SAX 2.0

参见:

• Parser
• XMLReader

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
void	characters(char[] ch, int start, int length)	适配一个SAX2字符事件。
void	endDocument()	结束文档事件。
void	endElement(String uri, String localName, String qName)	适配一个SAX2结束元素事件。
void	endPrefixMapping(String prefix)	适配一个SAX2结束前缀映射事件。
void	ignorableWhitespace(char[] ch, int start, int length)	适配一个SAX2可忽略的空白字符事件。
void	parse(String systemId)	解析文档。
void	parse(InputSource input)	解析文档。
void	processingInstruction(String target, String data)	适配一个SAX2处理指令事件。
void	setDocumentHandler(DocumentHandler handler)	注册SAX1文档事件处理程序。
void	setDocumentLocator(Locator locator)	设置文档定位器。
void	setDTDHandler(DTDHandler handler)	注册DTD事件处理程序。
void	setEntityResolver(EntityResolver resolver)	注册实体解析器。
void	setErrorHandler(ErrorHandler handler)	注册错误事件处理程序。
void	setLocale(Locale locale)	设置用于错误报告的区域设置。
void	skippedEntity(String name)	适配一个SAX2跳过实体事件。
void	startDocument()	开始文档事件。
void	startElement(String uri, String localName, String qName, Attributes atts)	适配一个SAX2开始元素事件。
void	startPrefixMapping(String prefix, String uri)	适配一个SAX2开始前缀映射事件。

Methods declared in class java.lang.Object

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

Methods declared in interface org.xml.sax.ContentHandler

declaration

Constructor Details

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。

Method Details

setLocale

             public void setLocale(Locale locale) throws SAXException
            

设置用于错误报告的区域设置。

在SAX2中不支持此功能，将始终抛出异常。

指定者:

setLocale 在接口 Parser中

参数:

locale - 用于错误报告的区域设置。

抛出:

SAXException - 除非被覆盖，否则会抛出异常。

参见:

• Parser.setLocale(java.util.Locale)

setEntityResolver

             public void setEntityResolver(EntityResolver resolver)
            

注册实体解析器。

指定者:

setEntityResolver 在接口 Parser中

参数:

resolver - 新的解析器。

参见:

• Parser.setEntityResolver(org.xml.sax.EntityResolver)

setDTDHandler

             public void setDTDHandler(DTDHandler handler)
            

注册DTD事件处理程序。

指定者:

setDTDHandler 在接口 Parser中

参数:

handler - 新的DTD事件处理程序。

参见:

• Parser.setDTDHandler(org.xml.sax.DTDHandler)

setDocumentHandler

             public void setDocumentHandler(DocumentHandler handler)
            

注册SAX1文档事件处理程序。

请注意，SAX1文档处理程序不支持命名空间。

指定者:

setDocumentHandler 在接口 Parser中

参数:

handler - 新的SAX1文档事件处理程序。

参见:

• Parser.setDocumentHandler(org.xml.sax.DocumentHandler)

setErrorHandler

             public void setErrorHandler(ErrorHandler handler)
            

注册错误事件处理程序。

指定者:

setErrorHandler 在接口 Parser中

参数:

handler - 新的错误事件处理程序。

参见:

• Parser.setErrorHandler(org.xml.sax.ErrorHandler)

parse

             public void parse(String systemId) throws IOException, SAXException
            

解析文档。

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

指定者:

parse 在接口 Parser中

参数:

systemId - 文档的绝对URL。

抛出:

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

SAXException - 如果处理文档时出现问题。

参见:

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

parse

             public void parse(InputSource input) throws IOException, SAXException
            

解析文档。

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

指定者:

parse 在接口 Parser中

参数:

input - 文档的输入源。

抛出:

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

SAXException - 如果处理文档时出现问题。

参见:

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

setDocumentLocator

             public void setDocumentLocator(Locator locator)
            

设置文档定位器。

指定者:

setDocumentLocator 在接口 ContentHandler中

参数:

locator - 文档定位器。

参见:

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

startDocument

             public void startDocument() throws SAXException
            

开始文档事件。

指定者:

startDocument 在接口 ContentHandler中

抛出:

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

参见:

• ContentHandler.startDocument()

endDocument

             public void endDocument() throws SAXException
            

结束文档事件。

指定者:

endDocument 在接口 ContentHandler中

抛出:

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

参见:

• ContentHandler.endDocument()

startPrefixMapping

             public void startPrefixMapping(String prefix, String uri)
            

适配一个SAX2开始前缀映射事件。

指定者:

startPrefixMapping 在接口 ContentHandler

参数:

prefix - 被映射的前缀。

uri - 被映射的命名空间URI。

参见:

• ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

endPrefixMapping

             public void endPrefixMapping(String prefix)
            

适应SAX2结束前缀映射事件。

指定者:

endPrefixMapping 在接口 ContentHandler

参数:

prefix - 被映射的前缀。

参见:

• ContentHandler.endPrefixMapping(java.lang.String)

startElement

             public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException
            

适应SAX2开始元素事件。

指定者:

startElement 在接口 ContentHandler

参数:

uri - 命名空间URI。

localName - 命名空间本地名称。

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

atts - SAX2属性。

抛出:

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

参见:

• ContentHandler.endDocument()

endElement

             public void endElement(String uri, String localName, String qName) throws SAXException
            

适应SAX2结束元素事件。

指定者:

endElement 在接口 ContentHandler

参数:

uri - 命名空间URI。

localName - 命名空间本地名称。

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

抛出:

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

参见:

• ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

characters

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

适应SAX2字符事件。

指定者:

characters 在接口 ContentHandler

参数:

ch - 字符数组。

start - 数组中的起始位置。

length - 要使用的字符数。

抛出:

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

参见:

• ContentHandler.characters(char[], int, int)

ignorableWhitespace

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

适应SAX2可忽略的空白字符事件。

指定者:

ignorableWhitespace 在接口 ContentHandler

参数:

ch - 字符数组。

start - 数组中的起始位置。

length - 要使用的字符数。

抛出:

SAXException - 可由子类抛出。

参见:

• ContentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

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

适应SAX2处理指令事件。

指定者:

processingInstruction 在接口 ContentHandler

参数:

target - 处理指令目标。

data - 处理指令的其余部分。

抛出:

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

参见:

• ContentHandler.processingInstruction(java.lang.String, java.lang.String)

skippedEntity

             public void skippedEntity(String name) throws SAXException
            

适应SAX2跳过实体事件。

指定者:

skippedEntity 在接口 ContentHandler

参数:

name - 被跳过的实体的名称。

抛出:

SAXException - 可由子类抛出。

参见:

• ContentHandler.skippedEntity(java.lang.String)