compact2, compact3

javax.xml.parsers

Class SAXParser

java.lang.Object

javax.xml.parsers.SAXParser

public abstract class SAXParser
extends Object

定义包装 XMLReader实现类的API。在JAXP 1，这类包裹 Parser接口，但是这个接口是由 XMLReader取代。为了便于过渡，这个类将继续支持相同的名称和接口，以及支持新方法。这个类的实例可以从 SAXParserFactory.newSAXParser()方法得到的。一旦这个类的一个实例获得，XML可以从各种输入源解析。这些输入源文件的URL，InputStreams，萨克斯inputsources。

这种静态方法创建一个基于系统属性设置的新工厂实例，或者如果没有定义任何属性，则使用该平台默认值。

控制，工厂实现来创建命名"javax.xml.parsers.SAXParserFactory"系统属性。这个属性名为这个抽象类的一个具体子类的类。如果没有定义属性，将使用一个平台默认值。

为内容是由底层的解析器解析，给出 HandlerBase或 DefaultHandler方法被称为。

这类包装的底层实现的用户可以考虑使用ParserAdapter类开始适应这类下SAX1实施修订工作。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	SAXParser() 保护以防止instaniation构造函数。

方法摘要

Modifier and Type	Method and Description
abstract Parser	getParser() 返回的SAX解析器，包覆纳米这个类的实现。
abstract Object	getProperty(String name) 返回特定的性能要求在 XMLReader底层的实现。
Schema	getSchema() 得到一个参考的 Schema由XML处理器。
abstract XMLReader	getXMLReader() 返回 XMLReader是由这个类的实现封装。
abstract boolean	isNamespaceAware() 指示是否这个解析器配置理解命名空间。
abstract boolean	isValidating() 指示此解析器是否被配置来验证XML文档。
boolean	isXIncludeAware() 得到这个解析器的XInclude处理模式。
void	parse(File f, DefaultHandler dh) 解析该文件的内容指定为XML使用指定的 DefaultHandler。
void	parse(File f, HandlerBase hb) 解析该文件的内容指定为XML使用指定的 HandlerBase。
void	parse(InputSource is, DefaultHandler dh) 解析内容给予 InputSource XML使用指定的 DefaultHandler。
void	parse(InputSource is, HandlerBase hb) 解析内容给予 InputSource XML使用指定的 HandlerBase。
void	parse(InputStream is, DefaultHandler dh) 解析给定的 InputStream实例的内容为XML使用指定的 DefaultHandler。
void	parse(InputStream is, DefaultHandler dh, String systemId) 解析给定的 InputStream实例的内容为XML使用指定的 DefaultHandler。
void	parse(InputStream is, HandlerBase hb) 解析给定的 InputStream实例的内容为XML使用指定的 HandlerBase。
void	parse(InputStream is, HandlerBase hb, String systemId) 解析给定的 InputStream实例的内容为XML使用指定的 HandlerBase。
void	parse(String uri, DefaultHandler dh) 解析由提供统一资源标识符（URI）所描述的内容为XML使用指定的 DefaultHandler。
void	parse(String uri, HandlerBase hb) 解析由提供统一资源标识符（URI）所描述的内容为XML使用指定的 HandlerBase。
void	reset() 这 SAXParser复位到原来的配置。
abstract void	setProperty(String name, Object value) 在 XMLReader底层实现的特定属性集。

Methods inherited from class java.lang.Object

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

Constructor Detail

SAXParser

protected SAXParser()

保护以防止instaniation构造函数。使用SAXParserFactory.newSAXParser()。

方法详细信息

reset

public void reset()

这SAXParser复位到原来的配置。

SAXParser设置为相同的状态时，它的创建与SAXParserFactory.newSAXParser()。reset()旨在让现有的SAXParsers节约与新SAXParsers创作相关资源的重用。

复位SAXParser不能保证有相同的Schema Object，例如Object.equals(Object obj)。这是保证有一个功能相同的Schema。

异常

UnsupportedOperationException当实现不重写这个方法

从以下版本开始：

一点五

parse

public void parse(InputStream is,
                  HandlerBase hb)
           throws SAXException,
                  IOException

解析给定的InputStream实例的内容为XML使用指定的HandlerBase。使用这种方法的defaulthandler版推荐为handlerbase类已在萨克斯2否决。

参数

is -包含内容进行解析输入流。

hb -萨克斯handlerbase使用。

异常

IllegalArgumentException -如果给定的InputStream是空的。

SAXException如果产生一个萨克斯误差解析。

IOException如果IO错误出现的 InputStream相互作用。

另请参见：

DocumentHandler

parse

public void parse(InputStream is,
                  HandlerBase hb,
                  String systemId)
           throws SAXException,
                  IOException

解析给定的InputStream实例的内容为XML使用指定的HandlerBase。使用这种方法的defaulthandler版推荐为handlerbase类已在萨克斯2否决。

参数

is -包含内容进行解析输入流。

hb -萨克斯handlerbase使用。

systemId - systemid是相对URI需要解决。

异常

IllegalArgumentException -如果给定的 InputStream是 null。

IOException -如果任何IO错误发生的 InputStream相互作用。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

version of this method instead.

parse

public void parse(InputStream is,
                  DefaultHandler dh)
           throws SAXException,
                  IOException

解析给定的 InputStream实例的内容为XML使用指定的 DefaultHandler。

参数

is -包含内容进行解析输入流。

dh -萨克斯defaulthandler使用。

异常

IllegalArgumentException -如果给定的InputStream是空的。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

DocumentHandler

parse

public void parse(InputStream is,
                  DefaultHandler dh,
                  String systemId)
           throws SAXException,
                  IOException

解析给定的 InputStream实例的内容为XML使用指定的 DefaultHandler。

参数

is -包含内容进行解析输入流。

dh -萨克斯defaulthandler使用。

systemId - systemid是相对URI需要解决。

异常

IllegalArgumentException -如果给定的InputStream是空的。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

version of this method instead.

parse

public void parse(String uri,
                  HandlerBase hb)
           throws SAXException,
                  IOException

解析由提供统一资源标识符（URI）所描述的内容为XML使用指定的 HandlerBase。使用这种方法的defaulthandler版推荐为handlerbase类已在萨克斯2否决

参数

uri -内容分析的位置。

hb -萨克斯handlerbase使用。

异常

IllegalArgumentException -如果URI是空的。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

DocumentHandler

parse

public void parse(String uri,
                  DefaultHandler dh)
           throws SAXException,
                  IOException

解析由提供统一资源标识符（URI）所描述的内容为XML使用指定的 DefaultHandler。

参数

uri -内容分析的位置。

dh -萨克斯defaulthandler使用。

异常

IllegalArgumentException -如果URI是空的。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

DocumentHandler

parse

public void parse(File f,
                  HandlerBase hb)
           throws SAXException,
                  IOException

解析该文件的内容指定为XML使用指定的 HandlerBase。使用这种方法的defaulthandler版推荐为handlerbase类已在萨克斯2否决

参数

f包含XML解析文件

hb -萨克斯handlerbase使用。

异常

IllegalArgumentException -如果文件对象为空。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

DocumentHandler

parse

public void parse(File f,
                  DefaultHandler dh)
           throws SAXException,
                  IOException

解析该文件的内容指定为XML使用指定的 DefaultHandler。

参数

f包含XML解析文件

dh -萨克斯defaulthandler使用。

异常

IllegalArgumentException -如果文件对象为空。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

DocumentHandler

parse

public void parse(InputSource is,
                  HandlerBase hb)
           throws SAXException,
                  IOException

解析内容给予 InputSource XML使用指定的 HandlerBase。使用这种方法的defaulthandler版推荐为handlerbase类已在萨克斯2否决

参数

is -包含内容进行解析inputsource。

hb -萨克斯handlerbase使用。

异常

IllegalArgumentException -如果 InputSource对象是 null。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

DocumentHandler

parse

public void parse(InputSource is,
                  DefaultHandler dh)
           throws SAXException,
                  IOException

解析内容给予 InputSource XML使用指定的 DefaultHandler。

参数

is -包含内容进行解析inputsource。

dh -萨克斯defaulthandler使用。

异常

IllegalArgumentException -如果 InputSource对象是 null。

IOException -如果出现任何IO错误。

SAXException -如果任何SAX的过程中发生错误的处理。

另请参见：

DocumentHandler

getParser

public abstract Parser getParser()
                          throws SAXException

返回的SAX解析器，包覆纳米这个类的实现。

结果

SAX解析器，包覆纳米这个类的实现。

异常

SAXException -如果任何SAX的过程中发生错误的处理。

getXMLReader

public abstract XMLReader getXMLReader()
                                throws SAXException

返回 XMLReader是由这个类的实现封装。

结果

XmlReader是由这个类的实现封装。

异常

SAXException -如果任何SAX的过程中发生错误的处理。

isNamespaceAware

public abstract boolean isNamespaceAware()

指示是否这个解析器配置理解命名空间。

结果

如果这个解析器配置理解命名空间真；否则为false。

isValidating

public abstract boolean isValidating()

指示此解析器是否被配置来验证XML文档。

结果

如果此解析器配置为验证XML文档，则为真；否则为。

setProperty

public abstract void setProperty(String name,
                                 Object value)
                          throws SAXNotRecognizedException,
                                 SAXNotSupportedException

在XMLReader底层实现的特定属性集。一个列表的核心功能和属性可以发现在 http://sax.sourceforge.net/?selected=get-set。

实现JAXP 1.5或更新版本的所有实现都必须支持的XMLConstants.ACCESS_EXTERNAL_DTD和XMLConstants.ACCESS_EXTERNAL_SCHEMA性质。

• 设置XMLConstants.ACCESS_EXTERNAL_DTD性质限制外部DTDs的访问，外部实体引用的属性指定的协议。如果访问被拒绝，在分析过程中，由于这种性质的限制，SAXException将被解析的方法被定义SAXParser。

  设置XMLConstants.ACCESS_EXTERNAL_SCHEMA财产限制外部架构的schemaLocation属性由属性指定的协议的访问。如果访问被拒绝，在分析过程中，由于这种性质的限制，SAXException将通过解析的方法抛出SAXParser定义。

参数

name -属性的名称是。

value -属性要设置的值。

异常

SAXNotRecognizedException -当标的XmlReader无法识别的属性名称。

SAXNotSupportedException -当标的XmlReader识别属性名称，但不支持的属性。

另请参见：

XMLReader.setProperty(java.lang.String, java.lang.Object)

getProperty

public abstract Object getProperty(String name)
                            throws SAXNotRecognizedException,
                                   SAXNotSupportedException

返回特定的性能要求在XMLReader底层的实现。

参数

name -属性的名称进行检索。

结果

请求属性的值。

异常

SAXNotRecognizedException -当标的XmlReader无法识别的属性名称。

SAXNotSupportedException -当标的XmlReader识别属性名称，但不支持的属性。

另请参见：

XMLReader.getProperty(java.lang.String)

getSchema

public Schema getSchema()

得到一个参考的Schema由XML处理器。

如果没有模式正在被使用，null返回。

结果

Schema正在使用或 null如果没有使用

异常

UnsupportedOperationException当实施不重写这个方法

从以下版本开始：

一点五

isXIncludeAware

public boolean isXIncludeAware()

得到这个解析器的XInclude处理模式。

结果

返回值的 SAXParserFactory.isXIncludeAware()当解析器创建工厂。

异常

UnsupportedOperationException当实施不重写这个方法

从以下版本开始：

一点五

另请参见：

SAXParserFactory.setXIncludeAware(boolean)