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

Class SAXParseException

  • 实现的所有接口
    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
    另请参见：
    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，则它将完全解析。

        结果
        包含系统标识符的字符串，如果没有，则为null。
        另请参见：
        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
        结果
        此异常的字符串表示形式。