java.sql
類別 SQLException

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

所有已實作的介面：

Serializable, Iterable<Throwable>

直接已知子類別：

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

public class SQLException
extends Exception
implements Iterable<Throwable>

提供關於資料庫存取錯誤或其他錯誤資訊的異常。

每個 SQLException 都可提供以下多種訊息：

• 描述錯誤的字元串。此字元串用作 Java Exception 訊息，可以通過方法 getMessage 獲得。
• "SQLstate" 字元串，該字元串遵守 XOPEN SQLstate 約定或 SQL:2003 約定。SQLState 字元串的值在適當的規範中描述。DatabaseMetaData 的方法 getSQLStateType 可用於確定驅動程序返回 XOPEN 型別還是 SQL:2003 型別。
• 特定於每個供應商的整數錯誤程式碼。通常，這將是底層資料庫返回的實際錯誤程式碼。
• 到下一個 Exception 的連接。可以使用此連接提供其他錯誤資訊。
• 因果關係，如果存在任何導致此 SQLException 的原因。

另請參見：

序列化表格

建構子摘要

SQLException()
建構一個 SQLException 物件。

SQLException(String reason)
建構一個具有給定 reason 的 SQLException 物件。

SQLException(String reason, String SQLState)
建構一個具有給定 reason 和 SQLState 的 SQLException 物件。

SQLException(String reason, String SQLState, int vendorCode)
建構一個具有給定 reason、SQLState 和 vendorCode 的 SQLException 物件。

SQLException(String reason, String sqlState, int vendorCode, Throwable cause)
建構一個具有給定 reason、SQLState、vendorCode 和 cause 的 SQLException 物件。

SQLException(String reason, String sqlState, Throwable cause)
建構一個具有給定 reason、SQLState 和 cause 的 SQLException 物件。

SQLException(String reason, Throwable cause)
建構一個具有給定 reason 和 cause 的 SQLException 物件。

SQLException(Throwable cause)
建構一個具有給定 cause 的 SQLException 物件。

方法摘要

int	getErrorCode() 獲取此 SQLException 物件的特定於供應商的異常程式碼。
SQLException	getNextException() 通過 setNextException(SQLException ex) 獲取連接到此 SQLException 物件的異常。
String	getSQLState() 獲取此 SQLException 物件的 SQLState。
Iterator<Throwable>	iterator() 返回在連接的 SQLExceptions 上進行迭代的迭代器。
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)

建構一個具有給定 reason、SQLState 和 vendorCode 的 SQLException 物件。cause 沒有初始化，隨後可調用 Throwable.initCause(java.lang.Throwable) 方法初始化。

參數：

reason - 對異常的描述

SQLState - 標識異常的 XOPEN 或 SQL:2003 程式碼

vendorCode - 特定於資料庫供應商的異常程式碼

SQLException

public SQLException(String reason,
                    String SQLState)

建構一個具有給定 reason 和 SQLState 的 SQLException 物件。cause 沒有初始化，隨後可調用 Throwable.initCause(java.lang.Throwable) 方法初始化。供應商程式碼被初始化為 0。

參數：

reason - 對異常的描述

SQLState - 標識異常的 XOPEN 或 SQL:2003 程式碼

SQLException

public SQLException(String reason)

建構一個具有給定 reason 的 SQLException 物件。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)

建構一個具有給定 cause 的 SQLException 物件。SQLState 被初始化為 null，供應商程式碼被初始化為 0。如果 cause==null，則 reason 被初始化為 null；如果 cause!=null，則初始化為 cause.toString()。

參數：

cause - 導致此 SQLException 的底層原因（保存此 cause，以供以後通過 getCause() 方法獲取）；此參數可以為 null，指示 cause 不存在或未知。

從以下版本開始：

1.6

SQLException

public SQLException(String reason,
                    Throwable cause)

建構一個具有給定 reason 和 cause 的 SQLException 物件。SQLState 被初始化為 null，供應商程式碼被初始化為 0。

參數：

reason - 對異常的描述。

cause - 導致此 SQLException 的底層原因（保存此 cause，以供以後通過 getCause() 方法獲取）；此參數可以為 null，指示 cause 不存在或未知。

從以下版本開始：

1.6

SQLException

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

建構一個具有給定 reason、SQLState 和 cause 的 SQLException 物件。供應商程式碼被初始化為 0。

參數：

reason - 對異常的描述。

sqlState - 標識異常的 XOPEN 或 SQL:2003 程式碼

cause - 導致此 SQLException 的底層原因（保存此 cause，以供以後通過 getCause() 方法獲取）；此參數可以為 null，指示 cause 不存在或未知。

從以下版本開始：

1.6

SQLException

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

建構一個具有給定 reason、SQLState、vendorCode 和 cause 的 SQLException 物件。

參數：

reason - 對異常的描述

sqlState - 標識異常的 XOPEN 或 SQL:2003 程式碼

vendorCode - 特定於資料庫供應商的異常程式碼

cause - 導致此 SQLException 的底層原因（保存此 cause，以供以後通過 getCause() 方法獲取）；此參數可以為 null，指示 cause 不存在或未知。

從以下版本開始：

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 連接末尾的新異常

另請參見：

getNextException()

iterator

public Iterator<Throwable> iterator()

返回在連接的 SQLExceptions 上進行迭代的迭代器。該迭代器將用來在每個 SQLException 及其底層 cause（如果有）進行迭代。

指定者：

介面 Iterable<Throwable> 中的 iterator

返回：

以適當的順序在連接的 SQLExceptions 和 cause 上進行迭代的迭代器

從以下版本開始：

1.6