Module java.xml
Package org.xml.sax

Class SAXParseException

java.lang.Object
java.lang.Throwable
java.lang.Exception
org.xml.sax.SAXException
org.xml.sax.SAXParseException
所有已实现的接口:
Serializable
public class SAXParseException extends SAXException
封装XML解析错误或警告。

此异常可能包含有关在原始XML文档中定位错误的信息，就好像它来自于一个Locator对象。请注意，尽管应用程序将作为参数接收到SAXParseException，传递给ErrorHandler接口中的处理程序，但应用程序实际上并不需要抛出异常；相反，它可以简单地读取其中的信息并采取不同的操作。

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

自从:
1.4, SAX 1.0
参见:

  • Constructor Details

    • SAXParseException

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

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

      参数:
      message - 错误或警告消息。
      locator - 用于错误或警告的定位器对象（可能为null）。
      参见:

    • SAXParseException

      public SAXParseException(String message, Locator locator, Exception e)
      在SAXParseException中包装现有异常。

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

      参数:
      message - 错误或警告消息，或为null以使用嵌入异常的消息。
      locator - 用于错误或警告的定位器对象（可能为null）。
      e - 任何异常。
      参见:

    • 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, Exception e)
      创建一个带有嵌入式异常的新SAXParseException。

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

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

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

  • Method Details

    • getPublicId

      public String getPublicId()
      获取异常发生的实体的公共标识符。
      返回:
      包含公共标识符的字符串，如果没有可用的则为null。
      参见:

    • getSystemId

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

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

      返回:
      包含系统标识符的字符串，如果没有可用的则为null。
      参见:

    • getLineNumber

      public int getLineNumber()
      异常发生的文本结尾的行号。

      第一行是第1行。

      返回:
      代表行号的整数，如果没有可用的则为-1。
      参见:

    • getColumnNumber

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

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

      返回:
      代表列号的整数，如果没有可用的则为-1。
      参见:

    • toString

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