compact2, compact3

java.sql

Class SQLException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.sql.SQLException

All Implemented Interfaces:

Serializable ， Iterable < Throwable >

已知直接子类：

BatchUpdateException ， RowSetWarning ， SerialException ， SQLClientInfoException ， SQLNonTransientException ， SQLRecoverableException ， SQLTransientException ， SQLWarning ， SyncFactoryException ， SyncProviderException

public class SQLException
extends 异常
implements Iterable<Throwable>

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

每个SQLException提供了几种信息：

• 描述错误的字符串。 这被用作Java异常消息，通过方法getMesasge 。
• 一个“SQLstate”字符串，它遵循XOPEN SQLstate约定或SQL：2003约定。 SQLState字符串的值在相应的规范中描述。 DatabaseMetaData方法getSQLStateType可用于发现驱动程序是否返回XOPEN类型或SQL：2003类型。
• 一个特定于每个供应商的整数错误代码。 通常这将是底层数据库返回的实际错误代码。
• 连锁到下一个例外。 这可以用于提供其他错误信息。
• 因果关系，如果有的话这个SQLException 。

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
SQLException() 构造一个 SQLException对象。
SQLException(String reason) 构造一个 SQLException对象与给定的 reason 。
SQLException(String reason, String SQLState) 构造一个 SQLException对象与给定的 reason和 SQLState 。
SQLException(String reason, String SQLState, int vendorCode) 构造一个 SQLException与给定对象 reason ， SQLState和 vendorCode 。
SQLException(String reason, String sqlState, int vendorCode, Throwable cause) 构造一个 SQLException与给定对象 reason ， SQLState ， vendorCode和 cause 。
SQLException(String reason, String sqlState, Throwable cause) 构造一个 SQLException与给定对象 reason ， SQLState和 cause 。
SQLException(String reason, Throwable cause) 构造一个 SQLException对象与给定的 reason和 cause 。
SQLException(Throwable cause) 构造一个 SQLException对象与给定的 cause 。

方法摘要

Modifier and Type	Method and Description
int	getErrorCode() 检索此 SQLException对象的供应商特定异常代码。
SQLException	getNextException() 通过setNextException（SQLException ex）检索链接到此 SQLException对象的异常。
String	getSQLState() 检索此 SQLException对象的SQLState。
Iterator<Throwable>	iterator() 返回链接的SQLExceptions的迭代器。
void	setNextException(SQLException ex) 将 SQLException对象添加到链的末尾。

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

构造方法详细信息

SQLException

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

构造一个SQLException与给定对象reason ， SQLState和vendorCode 。 cause未初始化，可以随后通过调用Throwable.initCause(java.lang.Throwable)方法进行初始化 。

参数

reason - 异常的描述

SQLState - SQLState的XOPEN或SQL：2003代码

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

SQLException

public SQLException(String reason,
                    String SQLState)

构造一个SQLException对象与给定的reason和SQLState 。 cause未初始化，可以随后通过调用Throwable.initCause(java.lang.Throwable)方法进行初始化 。 供应商代码初始化为0。

参数

reason - 异常的描述

SQLState - SQLState的XOPEN或SQL：2003代码

SQLException

public SQLException(String reason)

构造一个SQLException对象与给定的reason 。 SQLState初始化为null ，供应商代码初始化为0. cause未初始化，可以随后通过调用Throwable.initCause(java.lang.Throwable)方法初始化 。

参数

reason - 异常的描述

SQLException

public SQLException()

构造一个SQLException对象。 的reason ， SQLState被初始化为null ，供应商代码被初始化为0。 cause没有初始化，随后可以通过向一个呼叫进行初始化Throwable.initCause(java.lang.Throwable)方法。

SQLException

public SQLException(Throwable cause)

构造一个SQLException对象与给定的cause 。 该SQLState被初始化为null ，供应商代码被初始化为0。 reason被初始化为null如果cause==null ，或cause.toString()如果cause!=null 。

参数

cause - 这个SQLException （其保存以供getCause()方法稍后检索）的根本原因; 可能为空，表示原因不存在或未知。

从以下版本开始：

1.6

SQLException

public SQLException(String reason,
                    Throwable cause)

构造一个SQLException对象与给定的reason和cause 。 SQLState初始化为null ，供应商代码初始化为0。

参数

reason - 异常的描述。

cause -底层原因SQLException （保存用于由稍后检索getCause()方法）; 可能为空，表示原因不存在或未知。

从以下版本开始：

1.6

SQLException

public SQLException(String reason,
                    String sqlState,
                    Throwable cause)

构造一个SQLException与给定对象reason ， SQLState和cause 。 供应商代码初始化为0。

参数

reason - 异常的描述。

sqlState - sqlState的XOPEN或SQL：2003代码

cause - SQLException （其保存以供getCause()方法稍后检索）的根本原因; 可能为空，表示原因不存在或未知。

从以下版本开始：

1.6

SQLException

public SQLException(String reason,
                    String sqlState,
                    int vendorCode,
                    Throwable cause)

构造一个 SQLException与给定对象 reason ， SQLState ， vendorCode和 cause 。

参数

reason - 异常的描述

sqlState - sqlState的XOPEN或SQL：2003代码

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

cause - 这个SQLException （其保存以供getCause()方法稍后检索）的根本原因; 可能为空，表示原因不存在或未知。

从以下版本开始：

1.6

方法详细信息

getSQLState

public String getSQLState()

检索此 SQLException对象的SQLState。

结果

SQLState值

getErrorCode

public int getErrorCode()

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

结果

供应商的错误代码

getNextException

public SQLException getNextException()

通过setNextException（SQLException ex）检索链接到此 SQLException对象的异常。

结果

链中的下一个SQLException对象; null如果没有

另请参见：

setNextException(java.sql.SQLException)

setNextException

public void setNextException(SQLException ex)

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

参数

ex - 将添加到 SQLException链结尾的新 SQLException

另请参见：

getNextException()

iterator

public Iterator<Throwable> iterator()

返回链接的SQLExceptions的迭代器。 迭代器将用于遍历每个SQLException及其基本原因（如果有的话）。

Specified by:

iterator在界面 Iterable<Throwable>

结果

在链接的SQLExceptions和原因按正确顺序的迭代器

从以下版本开始：

1.6