java.lang.Object java.lang.Throwable java.lang.Exception org.xml.sax.SAXException org.xml.sax.SAXParseException
public class SAXParseException
封装 XML 解析错误或警告。
此模块(包括源代码和文档)在公共域中,同时 没有担保。有关更多信息,请参阅 http://www.saxproject.org。
此异常好像来源于 Locator
对象那样可以包括用来在原始 XML 文档中查找错误的信息。注意,尽管应用程序将接收 SAXParseException 作为 ErrorHandler
接口中处理程序的参数,但实际上应用程序不需要抛出异常;它可以只是读取其中的信息,并采取不同的操作。
因为此异常是 SAXException
的子类,所以它继承了包装其他异常的能力。
SAXException
,
Locator
,
ErrorHandler
,
序列化表格
构造方法摘要 | |
---|---|
SAXParseException(String message, Locator locator) 从消息和 Locator 创建新的 SAXParseException。 |
|
SAXParseException(String message, Locator locator, Exception 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, Exception e) 创建带有嵌入异常的新 SAXParseException。 |
方法摘要 | |
---|---|
int |
getColumnNumber() 发生异常的文本结尾的列号。 |
int |
getLineNumber() 发生异常的文本结尾的行号。 |
String |
getPublicId() 获取发生异常的实体的公共标识符。 |
String |
getSystemId() 获取发生异常的实体的系统标识符。 |
从类 org.xml.sax.SAXException 继承的方法 |
---|
getException, getMessage, toString |
从类 java.lang.Throwable 继承的方法 |
---|
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
public SAXParseException(String message, Locator locator)
当应用程序从 ContentHandler
回调内创建其自己的异常时,此构造方法尤其有用。
message
- 错误或警告消息。
locator
- 错误或警告的 locator 对象(可以为 null)。
Locator
public SAXParseException(String message, Locator locator, Exception e)
当应用程序从 ContentHandler
回调内创建其自己的异常,并且需要包装不是 SAXException
的子类的现有异常时,此构造方法尤其有用。
message
- 错误或警告消息;或者为 null,以便使用来自于嵌入异常的消息。
locator
- 错误或警告的 locator 对象(可以为 null)。
e
- 任何异常。
Locator
public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber)
此构造方法对解析器编写者最为有用。
除消息之外的所有参数好像都是由 Locator
提供的。例如,如果系统标识符是一个 URL(包括相对文件名),则调用者必须在创建异常之前完全解析它。
message
- 错误或警告消息。
publicId
- 生成错误或警告的实体的公共标识符。
systemId
- 生成错误或警告的实体的系统标识符。
lineNumber
- 引起错误或警告的文本结尾的行号。
columnNumber
- 引起错误或警告的文本结尾的列号。
public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, Exception e)
对于需要包装不是 SAXException
的子类的异常的解析器编写者,此构造方法最有用。
除消息和异常之外的所有参数好像都是由 Locator
提供的。例如,如果系统标识符是 URL(包括相对文件名),则调用者必须在创建该异常之前完全解析它。
message
- 错误或警告消息,或者 null,以便使用来自于嵌入的异常的消息。
publicId
- 生成错误或警告的实体的公共标识符。
systemId
- 生成错误或警告的实体的系统标识符。
lineNumber
- 引起错误或警告的文本结尾的行号。
columnNumber
- 引起错误或警告的文本结尾的列号。
e
- 嵌入到此异常中的其他异常。
方法详细信息 |
---|
public String getPublicId()
Locator.getPublicId()
public String getSystemId()
如果系统标识符是 URL,则已得到了完全解析。
Locator.getSystemId()
public int getLineNumber()
第一行就是行 1。
Locator.getLineNumber()
public int getColumnNumber()
行中的第一列就是位置 1。
Locator.getColumnNumber()