SQLException 类提供了关于数据库访问错误的信息。

每个 SQLException 提供了几种信息：

 
• 一个描述错误的一个字符串。它被用作 Java Exception 消息，并可通过调用 getMesage() 方法使用它。
   
• 一个遵守 XOPEN SQLstate 约定的字符串 "SQLstate"。
      SQLState 字符串的值由 XOPEN SQL spec 约定描述。
   
• 一个供应商专用的整数错误代码。通常它是由当前使用的数据库返回的实际的错误代码。  
• 到下一个
  Exception 的链。 它可以用来提供附加的错误信息。
  

类 java.sql.SQLException

java.lang.Object
   |
   +----java.lang.Throwable
           |
           +----java.lang.Exception
                   |
                   +----java.sql.SQLException

public class SQLException

extends Exception

下列类的父类：
 

SQLWarning

构造子索引

SQLException()

构造一个 SQLException；reason 缺省为 null，SQLState 缺省为
null 且 vendorCode 缺省为 0。

SQLException(String)

用一个 reason 构造一个 SQLException；SQLState 缺省为
null 且 vendorCode 缺省为 0。

SQLException(String, String)

用一个 reason 和 SQLState 构造一个 SQLException；vendorCode 缺省为 0。

SQLException(String, String, int)

构造一个指定全部参数的 SQLException。

方法索引

getErrorCode()

获得供应商专用的异常代码

getNextException()

获得与该异常相链接的下一个异常。

getSQLState()

获得 SQLState

setNextException(SQLException)

在链的末端添加一个 SQLException 。

构造子

 public SQLException(String reason,
                     String SQLState,
                     int vendorCode)

构造一个指定全部参数的 SQLException。

 

参数：
 

reason - 异常的描述
 

SQLState - 标识异常的 XOPEN 代码
 

vendorCode - 一个数据库 vendor specific 异常代码

 public SQLException(String reason,
                     String SQLState)

用一个 reason 和 SQLState 构造一个 SQLException；vendorCode 缺省为 0。

 

参数：
 

reason - 异常的描述
 

SQLState - 标识异常的 XOPEN 代码

 public SQLException(String reason)

用一个 reason 构造一个 SQLException；SQLState 缺省为
null 且 vendorCode 缺省为 0。

 

参数：
 

reason - 异常的描述

 public SQLException()

构造一个 SQLException；reason 缺省为 null，SQLState 缺省为
null 且 vendorCode 缺省为 0。

方法

 public String getSQLState()

获得 SQLState

 

返回值：
 

SQLState 值

 public int getErrorCode()

获得供应商专用的异常代码

 

返回值：
 

供应商的错误代码

 public SQLException getNextException()

获得与该异常相链接的异常。

 

返回值：
 

链中的下一个 SQLException ，如果没有则为 null

 public synchronized void setNextException(SQLException ex)

在链的末端添加一个 SQLException 。

 

参数：
 

ex - SQLException 链新的结尾