SQLException (Java Platform SE 8 )

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

Class SQLException

构造方法摘要

方法摘要

Methods inherited from class java.lang.Throwable

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

构造方法详细信息

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

方法详细信息

getSQLState

getErrorCode

getNextException

setNextException

iterator