JavaTM 2 Platform
Standard Ed. 5.0

org.xml.sax
类 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 解析错误或警告。

此模块(包括源代码和文档)在公共域中,同时 没有担保有关更多信息,请参阅http://www.saxproject.org

此异常好像来源于 Locator 对象那样可以包括用来在原始 XML 文档中查找错误的信息。注意,尽管应用程序将接收 SAXParseException 作为 ErrorHandler 接口中处理程序的参数,但实际上应用程序不需要抛出异常;它可以只是读取其中的信息,并采取不同的操作。

因为此异常是 SAXException 的子类,所以它继承了包装其他异常的能力。

从以下版本开始:
SAX 1.0
另请参见:
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
 

构造方法详细信息

SAXParseException

public SAXParseException(String message,
                         Locator locator)
从消息和 Locator 创建新的 SAXParseException。

当应用程序从 ContentHandler 回调内创建其自己的异常时,此构造方法尤其有用。

参数:
message - 错误或警告消息。
locator - 错误或警告的 locator 对象(可以为 null)。
另请参见:
Locator

SAXParseException

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

当应用程序从 ContentHandler 回调内创建其自己的异常,并且需要包装不是 SAXException 的子类的现有异常时,此构造方法尤其有用。

参数:
message - 错误或警告消息;或者为 null,以便使用来自于嵌入异常的消息。
locator - 错误或警告的 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,
                         Exception 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()

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策