模块  java.xml
软件包  org.xml.sax

Interface Parser

  • 所有已知实现类：
    XMLReaderAdapter 
    @Deprecated(since="1.5")public interface Parser
    Deprecated.
    This interface has been replaced by the SAX2 XMLReader interface, which includes Namespace support.
    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的主要事件供应商界面; 它已在SAX2中由XMLReader替换，其中包括命名空间支持和复杂的可配置性和可扩展性。

    所有SAX1解析器都必须实现此基本接口：它允许应用程序为不同类型的事件注册处理程序，并从URI或字符流启动解析。

    所有SAX1解析器还必须实现零参数构造函数（尽管也允许使用其他构造函数）。

    SAX1解析器是可重用但不可重入的：应用程序可以在第一个解析成功完成后重用解析器对象（可能使用不同的输入源），但它可能不会在解析中递归调用parse（）方法。

    从以下版本开始：
    1.4，SAX 1.0
    另请参见：
    EntityResolver ， DTDHandler ， DocumentHandler ， ErrorHandler ， HandlerBase ， InputSource

    • 方法详细信息

      • setLocale

        void setLocale​(Locale locale)        throws SAXException
        Deprecated.
        允许应用程序请求错误和警告的区域设置。

        SAX解析器不需要提供错误和警告的本地化; 但是，如果它们不支持所请求的语言环境，则必须抛出SAX异常。 应用程序可能不会在解析过程中请求区域设置更改。

        参数
        locale - Java Locale对象。
        异常
        SAXException - 如果不支持请求的语言环境，则抛出异常（使用先前或默认语言环境）。
        另请参见：
        SAXException ， SAXParseException

      • setEntityResolver

        void setEntityResolver​(EntityResolver resolver)
        Deprecated.
        允许应用程序注册自定义实体解析程序。

        如果应用程序未注册实体解析程序，SAX解析器将解析系统标识符并打开与实体本身的连接（这是在HandlerBase中实现的默认行为）。

        应用程序可以在解析过程中注册新的或不同的实体解析程序，SAX解析器必须立即开始使用新的解析程序。

        参数
        resolver - 用于解析实体的对象。
        另请参见：
        EntityResolver ， HandlerBase

      • setDTDHandler

        void setDTDHandler​(DTDHandler handler)
        Deprecated.
        允许应用程序注册DTD事件处理程序。

        如果应用程序未注册DTD处理程序，则将自动忽略SAX解析器报告的所有DTD事件（这是HandlerBase实现的默认行为）。

        应用程序可以在解析过程中注册新的或不同的处理程序，SAX解析器必须立即开始使用新的处理程序。

        参数
        handler - DTD处理程序。
        另请参见：
        DTDHandler ， HandlerBase

      • setDocumentHandler

        void setDocumentHandler​(DocumentHandler handler)
        Deprecated.
        允许应用程序注册文档事件处理程序。

        如果应用程序未注册文档处理程序，则将静默忽略SAX解析器报告的所有文档事件（这是HandlerBase实现的默认行为）。

        应用程序可以在解析过程中注册新的或不同的处理程序，SAX解析器必须立即开始使用新的处理程序。

        参数
        handler - 文档处理程序。
        另请参见：
        DocumentHandler ， HandlerBase

      • setErrorHandler

        void setErrorHandler​(ErrorHandler handler)
        Deprecated.
        允许应用程序注册错误事件处理程序。

        如果应用程序没有注册错误事件处理程序，SAX解析器报告的所有错误事件都将被忽略，但fatalError除外，它将抛出SAXException（这是HandlerBase实现的默认行为）。

        应用程序可以在解析过程中注册新的或不同的处理程序，SAX解析器必须立即开始使用新的处理程序。

        参数
        handler - 错误处理程序。
        另请参见：
        ErrorHandler ， SAXException ， HandlerBase

      • parse

        void parse​(String systemId)    throws SAXException,           IOException
        Deprecated.
        从系统标识符（URI）解析XML文档。

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

          parse(new InputSource(systemId));

        如果系统标识符是URL，则在将其传递给解析器之前，应用程序必须完全解析该URL。

        参数
        systemId - 系统标识符（URI）。
        异常
        SAXException - 任何SAX异常，可能包装另一个异常。
        IOException - 解析器的IO异常，可能来自应用程序提供的字节流或字符流。
        另请参见：
        parse(org.xml.sax.InputSource)