java.sql
类 SQLException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.sql.SQLException

所有已实现的接口：

Serializable

直接已知子类：

BatchUpdateException, RowSetWarning, SerialException, SQLWarning, SyncFactoryException, SyncProviderException

public class SQLException
extends Exception

该异常提供关于数据库访问错误或其他错误的信息。

每个 SQLException 都可提供以下多种消息：

• 描述错误的字符串。此字符串用作 Java Exception 消息，可以通过方法 getMesage 使用。
• "SQLstate" 字符串，该字符串遵守 XOPEN SQLstate 约定或 SQL 99 约定。SQLState 字符串的值在适当的规范中描述。DatabaseMetaData 的方法 getSQLStateType 可用于发现驱动程序返回 XOPEN 类型还是 SQL 99 类型。
• 特定于每个供应商的整数错误代码。通常，这将是底层数据库返回的实际错误代码。
• 到下一个 Exception 的链接。可以使用此链接提供其他错误信息。

另请参见：

序列化表格

构造方法摘要

SQLException()
构造一个 SQLException 对象；reason 字段默认为 null，SQLState 字段默认为 null，vendorCode 字段默认为 0。

SQLException(String reason)
构造一个带原因的 SQLException 对象；SQLState 字段默认为 null，vendorCode 字段默认为 0。

SQLException(String reason, String SQLState)
构造一个带有给定原因和 SQLState 的 SQLException 对象；vendorCode 字段默认为 0。

SQLException(String reason, String SQLState, int vendorCode)
构造一个完全限定的 SQLException 对象。

方法摘要

int	getErrorCode() 检索此 SQLException 对象的特定于供应商的异常代码。
SQLException	getNextException() 检索到此 SQLException 对象的异常链接。
String	getSQLState() 检索此 SQLException 对象的 SQLState。
void	setNextException(SQLException ex) 将 SQLException 对象添加到链接的末尾。

从类 java.lang.Throwable 继承的方法

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

从类 java.lang.Object 继承的方法

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

构造方法详细信息

SQLException

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

构造一个完全限定的 SQLException 对象。

参数：

reason - 对异常的描述

SQLState - 标识异常的 XOPEN 或 SQL 99 代码

vendorCode - 特定于数据库供应商的异常代码

SQLException

public SQLException(String reason,
                    String SQLState)

构造一个带有给定原因和 SQLState 的 SQLException 对象；vendorCode 字段默认为 0。

参数：

reason - 对异常的描述

SQLState - 标识异常的 XOPEN 或 SQL 99 代码

SQLException

public SQLException(String reason)

构造一个带原因的 SQLException 对象；SQLState 字段默认为 null，vendorCode 字段默认为 0。

参数：

reason - 对异常的描述

SQLException

public SQLException()

构造一个 SQLException 对象；reason 字段默认为 null，SQLState 字段默认为 null，vendorCode 字段默认为 0。

方法详细信息

getSQLState

public String getSQLState()

检索此 SQLException 对象的 SQLState。

返回：

SQLState 值

getErrorCode

public int getErrorCode()

检索此 SQLException 对象的特定于供应商的异常代码。

返回：

供应商的错误代码

getNextException

public SQLException getNextException()

检索到此 SQLException 对象的异常链接。

返回：

链接中的 SQLException 对象；如果不存在，则返回 null

另请参见：

setNextException(java.sql.SQLException)

setNextException

public void setNextException(SQLException ex)

将 SQLException 对象添加到链接的末尾。

参数：

ex - 将添加到 SQLException 链接的末尾的新异常

另请参见：

getNextException()