JDBC學習筆記之SQLException介紹

1. SQLException 的概述

當使用 JDBC 與數據源(在本文中的數據源表示我們實際使用的數據庫)進行交互的時候遇見錯誤的時候，將會拋出名為 SQLException 的異常。一個 SQLException 的異常里面包含以下信息，用於幫助我們更好的定位錯誤。

1. 錯誤表示：
   使用 getMessage 方法便可以獲取。
2. SQLState 代碼
   代碼有五位的字母和數字組成 。多數的代碼由 ISO/ANSI 和 Open Group(X/Open) 標准化，但是仍然存在部分的代碼由數據庫提供商自行實現。
   使用 getSQLState 方法便可以獲取。
3. 錯誤代碼
   與 SQLState 不同，錯誤代碼是由數據庫提供商自行定義的整數值，存在是由基礎數據源返回的實際錯誤代碼的可能。
   使用 getErrorCode 方法便可以獲取。
4. 錯誤原因
   表示引發異常的原因，通過不斷調用 getCause 方法可以獲取異常發生的底層原因。
5. 異常鏈
   如果出現多個錯誤，則通過此鏈引用異常。
   使用 getNextException 方法便可以獲取。

2. SQLException的示例

public static void printSQLException(SQLException e){
    for(Throwable e ：ex){
        if (e instanceof SQLException){
            if(ignoreSQLException(((SQLException)e).getSQLState()) == false){
                e.printStackTrace(System.err);
                System.err.println("SQLState:" + ((SQLException)e).getSQLState());
                System.err.println("Error Code:" + ((SQLException)e).getErrorCode());
                System.err.println("Message:" + e.getMessage());
                Throwable t = ex.getCause();
                while(t != null){
                    System.out.println("Cause :" + t);
                    t = t.getCause();
                }
            }
        }
    }
}
 
public static boolean ignoreSQLException(String sqlState){
    if(sqlState == null){
        System.out.println("The SQL state is not defined");
    }

    // X0Y32：Jar file already exists in schema
    if(sqlState.equalsIgnoreCase("X0Y32")){
        return true;
    }

    // 42Y55：Table already exists in schema
    if(sqlState.equalsIgnoreCase("42Y55")){
        return true;
    }

    return true;
}

說明：上面的代碼取自 [http:docs.oracle.com] (http://docs.oracle.com/javase/tutorial/jdbc/basics/sqlexception.html)。

3. SQLWarning

SQLWarning 是 SQLException 的一個非常重要的子類，用於表示數據庫訪問時出現的警告。作為異常，SQLWarning 不會停止執行應用程序，而是提醒用戶沒有按計划發生任何事情。比如，警告有可能會通知你嘗試撤銷的某個權限沒有成功，或者通知你在請求斷開的時間可能發生錯誤。
SQLWarning 有可能被 Connection 、Statement (包括 PreparedStatement 和 CallableStatement)或 ResultSet 報告，這些類都存在 getWarnings 方法，通過調用該方法才能看到調用對象上報告的第一個警告。如果 getWarning 返回一個警告，我們可以調用其 getNextWarning 方法獲取下一個警告。每執行一行語句，那么前面那行語句的警告將會清除，這意味着如果我們想要檢索報告處理來的警告，那么必須在下一行語句執行之前檢索。

DataTruncation 是最常見的警告，其SQLState代碼均為01004，表示在讀取和寫入數據的時候存在問題。DataTruncation 有很多方法可以幫助我們去理解哪個列或參數數據被截斷，截斷是在讀取還是寫入操作，應該傳輸多少字節以及實際傳輸的字節數。

4. 其他類型的SQLException

1. BatchUpdateException：在批處理更新操作期間發生錯誤時，將引發除了所提供的信息，提供的更新計數被處死之前出現了錯誤的所有語句。
2. SQLClientInfoException：當無法在連接上設置一個或多個客戶端信息屬性時引發。除了所提供的信息，也提供了不設置的客戶端信息屬性的列表。
3. so on...