compact2, compact3

org.xml.sax

Class SAXParseException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.xml.sax.SAXException

org.xml.sax.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 ，它继承了包装其他异常的能力。

从以下版本开始：

SAX 1.0

Version:

2.0.1（sax2r2）

另请参见：

SAXException ， Locator ， ErrorHandler ， Serialized Form

构造方法摘要

构造方法

Constructor and Description
SAXParseException(String message, Locator locator) 从消息和定位器创建新的SAXParseException。
SAXParseException(String message, Locator locator, 异常 e) 在SAXParseException中包装一个现有的异常。
SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber) 创建一个新的SAXParseException。
SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, 异常 e) 创建一个新的SAXParseException与嵌入式异常。

方法摘要

Modifier and Type	Method and Description
int	getColumnNumber() 发生异常的文本结尾的列号。
int	getLineNumber() 出现异常的文本结尾的行号。
String	getPublicId() 获取发生异常的实体的公共标识符。
String	getSystemId() 获取发生异常的实体的系统标识符。
String	toString() 覆盖toString以提供更详细的错误消息。

Methods inherited from class org.xml.sax.SAXException

getCause, getException, getMessage

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

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

结果

此异常的字符串表示形式。