Module  java.xml
软件包  org.xml.sax

Class SAXParseException

  • All Implemented Interfaces:
    Serializable 

    public class SAXParseException
extends SAXException
    封装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.

    此异常可能包括用于在原始XML文档中查找错误的信息，就像来自Locator对象一样。 请注意，虽然应用程序将收到一个SAXParseException作为ErrorHandler接口中处理程序的参数，但实际上并不需要应用程序来抛出异常; 相反，它可以简单地读取其中的信息，并采取不同的动作。

    由于此异常是一个SAXException的子类，因此它继承了包装另一个异常的能力。

    从以下版本开始：
    1.4，SAX 1.0
    Version:
    2.0.1（sax2r2）
    另请参见：
    SAXException ， Locator ， ErrorHandler ， Serialized Form

    • 构造方法详细信息

      • SAXParseException

        public SAXParseException​(String message,
                         Locator locator)
        从消息和定位器创建新的SAXParseException。

        当应用程序在ContentHandler回调中创建自己的异常时，此构造函数特别有用。

        参数
        message - 错误或警告消息。
        locator - 错误或警告的定位器对象（可能为null）。
        另请参见：
        Locator

      • SAXParseException

        public SAXParseException​(String message,
                         Locator locator,
                         异常 e)
        在SAXParseException中包装一个现有的异常。

        当应用程序在ContentHandler回调中创建自己的异常，并且需要包装不是SAXException的子类的现有异常时，此构造函数特别有用。

        参数
        message - 错误或警告消息，或使用来自嵌入式异常的消息为null。
        locator - 错误或警告的定位器对象（可能为null）。
        e - 任何异常。
        另请参见：
        Locator

      • SAXParseException

        public SAXParseException​(String message,
                         String publicId,
                         String systemId,
                         int lineNumber,
                         int columnNumber)
        创建一个新的SAXParseException。

        此构造函数对解析器作者最有用。

        除消息之外的所有参数如同由Locator提供的一样 。 例如，如果系统标识符是URL（包括相对文件名），则调用者必须在创建异常之前完全解析它。

        参数
        message - 错误或警告消息。
        publicId - 生成错误或警告的实体的公共标识符。
        systemId - 生成错误或警告的实体的系统标识符。
        lineNumber - 导致错误或警告的文本结尾的行号。
        columnNumber - 导致错误或警告的文本结尾的列号。

      • SAXParseException

        public SAXParseException​(String message,
                         String publicId,
                         String systemId,
                         int lineNumber,
                         int columnNumber,
                         异常 e)
        创建一个新的SAXParseException与嵌入式异常。

        此构造函数对于需要包装不是SAXException的子类的异常的解析器作者最有用。

        除消息和异常之外的所有参数如同由Locator提供的一样 。 例如，如果系统标识符是URL（包括相对文件名），则调用者必须在创建异常之前完全解析它。

        参数
        message - 错误或警告消息，或为使用嵌入式异常的消息为null。
        publicId - 生成错误或警告的实体的公共标识符。
        systemId - 生成错误或警告的实体的系统标识符。
        lineNumber - 导致错误或警告的文本结尾的行号。
        columnNumber - 导致错误或警告的文本结尾的列号。
        e - 另一个例外，嵌入在这一个。

    • 方法详细信息

      • getPublicId

        public String getPublicId​()
        获取发生异常的实体的公共标识符。
        结果
        包含公共标识符的字符串，如果没有可用，则为null。
        另请参见：
        Locator.getPublicId()

      • getSystemId

        public String getSystemId​()
        获取发生异常的实体的系统标识符。

        如果系统标识符是一个URL，它将被完全解析。

        结果
        包含系统标识符的字符串，如果没有可用，则为空。
        另请参见：
        Locator.getSystemId()

      • getLineNumber

        public int getLineNumber​()
        出现异常的文本结尾的行号。

        第一行是第1行。

        结果
        表示行号的整数，如果没有可用，则为-1。
        另请参见：
        Locator.getLineNumber()

      • getColumnNumber

        public int getColumnNumber​()
        发生异常的文本结尾的列号。

        一行中的第一列是位置1。

        结果
        表示列号的整数，如果没有可用，则为-1。
        另请参见：
        Locator.getColumnNumber()

      • toString

        public String toString​()
        覆盖toString以提供更详细的错误消息。
        重写：
        toString在 SAXException
        结果
        此异常的字符串表示形式。