compact2, compact3

org.xml.sax

Interface Parser

所有已知实现类：

XMLReaderAdapter

过时的。

此接口已被XMLReader SAX2接口所取代，其中包括命名空间的支持。

public interface Parser

基本接口SAX（Simple API for XML）解析器。

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.

这是主要的事件提供者接口SAX1；它一直在XMLReader SAX2的取代，其中包括命名空间的支持和先进的可配置性和可扩展性。

所有的SAX1解析器必须实现这个基本的界面：它允许申请登记为不同类型的事件处理程序和启动一个分析从一个URI，或者字符流。

所有的SAX1分析器还必须实现一零个参数的构造函数（虽然其他构造函数也可以）。

解析器是重用而不是SAX1折返：应用可重用解析器对象（可能使用不同的输入源）第一次解析已成功完成，但它可能不会调用parse()方法递归地在解析。

从以下版本开始：

萨克斯1

另请参见：

EntityResolver， DTDHandler， DocumentHandler， ErrorHandler， HandlerBase， InputSource

方法摘要

Modifier and Type	Method and Description
void	parse(InputSource source) 过时的。 解析一个XML文档。
void	parse(String systemId) 过时的。 解析一个XML文件从一个系统标识符（URI）。
void	setDocumentHandler(DocumentHandler handler) 过时的。 允许应用程序注册一个文档事件处理程序。
void	setDTDHandler(DTDHandler handler) 过时的。 允许应用程序登记DTD事件处理程序。
void	setEntityResolver(EntityResolver resolver) 过时的。 允许应用程序登记自定义实体解析器。
void	setErrorHandler(ErrorHandler handler) 过时的。 允许应用程序注册一个错误事件处理程序。
void	setLocale(Locale locale) 过时的。 允许应用程序请求错误和警告的区域设置。

方法详细信息

setLocale

void setLocale(Locale locale)
        throws SAXException

过时的。

允许应用程序请求错误和警告的区域设置。

SAX解析器不要求提供错误和警告的定位；如果他们不支持请求的现场，然而，他们必须把萨克斯例外。应用程序可能不请求在解析的中间设置区域设置。

参数

locale - java locale对象。

异常

SAXException -抛出一个异常（使用前或默认区域）如果所请求的区域设置是不支持的。

另请参见：

SAXException， SAXParseException

setEntityResolver

void setEntityResolver(EntityResolver resolver)

过时的。

允许应用程序登记自定义实体解析器。

如果应用程序没有登记实体解析器，SAX解析器将解决系统标识符和打开的连接实体本身（这是在HandlerBase实施的默认行为）。

应用程序可以登记一中解析新的或不同的实体解析器和SAX解析器必须立即开始使用新的解析器。

参数

resolver -解决实体对象。

另请参见：

EntityResolver， HandlerBase

setDTDHandler

void setDTDHandler(DTDHandler handler)

过时的。

允许应用程序登记DTD事件处理程序。

如果应用程序没有登记一个DTD处理，所有的DTD事件由SAX解析器报告会被忽略（这是由handlerbase默认行为）。

应用程序可以登记一个新的或不同的中解析处理，和SAX解析器必须立即开始使用新的处理程序。

参数

handler的DTD处理程序。

另请参见：

DTDHandler， HandlerBase

setDocumentHandler

void setDocumentHandler(DocumentHandler handler)

过时的。

允许应用程序注册一个文档事件处理程序。

如果应用程序没有登记的文件处理程序，所有文件事件由SAX解析器报告将被忽略（这是由handlerbase默认行为）。

应用程序可以登记一个新的或不同的中解析处理，和SAX解析器必须立即开始使用新的处理程序。

参数

handler -文档处理程序。

另请参见：

DocumentHandler， HandlerBase

setErrorHandler

void setErrorHandler(ErrorHandler handler)

过时的。

允许应用程序注册一个错误事件处理程序。

如果应用程序没有登记错误事件处理程序中，所有的错误事件由SAX解析器报告将被忽略掉，除了致命错误，这将saxexception（这是由handlerbase默认行为）。

应用程序可以登记一个新的或不同的中解析处理，和SAX解析器必须立即开始使用新的处理程序。

参数

handler -错误处理程序。

另请参见：

ErrorHandler， SAXException， HandlerBase

parse

void parse(InputSource source)
    throws SAXException,
           IOException

过时的。

解析一个XML文档。

应用程序可以使用此方法来指导SAX解析器开始解析XML文档的任何有效的输入源（字符流，字节流，或URI）。

应用程序可能不调用此方法，而解析正在进行中（他们应该为每个额外的xml文档创建一个新的解析器）。一旦一个解析完成，一个应用程序可能会重用相同的解析器对象，可能与一个不同的输入源。

参数

source为XML文档的顶层输入源。

异常

SAXException -萨克斯例外，可能是包装的另一个例外。

IOException -从解析器的IO异常，可能从一个字节流和字符流的应用程序提供的。

另请参见：

InputSource， parse(java.lang.String)， setEntityResolver(org.xml.sax.EntityResolver)， setDTDHandler(org.xml.sax.DTDHandler)， setDocumentHandler(org.xml.sax.DocumentHandler)， setErrorHandler(org.xml.sax.ErrorHandler)

parse

void parse(String systemId)
    throws SAXException,
           IOException

过时的。

解析一个XML文件从一个系统标识符（URI）。

此方法是从系统标识符中读取文档的常见情况的快捷方式。它是确切的相当于以下：

解析（新inputsource（systemid））；

如果系统标识符是一个网址，它必须在它被传递给解析器之前完全由应用程序解决。

参数

systemId -系统标识符（URI）。

异常

SAXException -萨克斯例外，可能是包装的另一个例外。

IOException -从解析器的IO异常，可能从一个字节流和字符流的应用程序提供的。

另请参见：

parse(org.xml.sax.InputSource)