模块  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
    另请参见:
    SAXExceptionLocatorErrorHandlerSerialized 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
        结果
        此异常的字符串表示形式。