Java org.xml.sax 类 SAXParseException（JDK5）

176 阅读 0 评论 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
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()