源碼解析Spring 數(shù)據(jù)庫異常抽理知識點總結

更新時間：2019年05月26日 11:24:32 投稿：laozhang

在本篇文章里小編給大家分享了關于源碼解析Spring 數(shù)據(jù)庫異常抽理知識點內(nèi)容，對此有需要的朋友們學習參考下。

數(shù)據(jù)庫為：H2

如果需要處理特定 SQL 異常，比如 SQL 語句錯誤，這個時候我們應該怎么辦？

查看 SQLException 源碼，我們可以發(fā)現(xiàn)兩個重要的方法。

SQLException.getErrorCode:返回數(shù)據(jù)庫特定的錯誤碼，由數(shù)據(jù)庫廠商制定，不同廠商錯誤碼不同。如重復主鍵錯誤碼在 MySQL 中是 1062，而在 Oracle 中卻是 1。

SQLException.getSQLState：返回 XOPEN 或 SQL:2003 制定的錯誤碼規(guī)范。數(shù)據(jù)庫廠商會將不同錯誤消息映射成同一個錯誤碼

所以我們可以根據(jù) SQLException.getErrorCode 處理相應的數(shù)據(jù)庫異常。

由于數(shù)據(jù)庫廠商錯誤碼不相同，這就導致如果我們更換數(shù)據(jù)庫，上面判斷邏輯就必須重寫。

下面我們使用 Spring 操作數(shù)據(jù)庫。

Spring 操作數(shù)據(jù)庫

使用 Spring 之后，我們不再需要強制捕獲異常。如果 SQL 語句運行存在異常，Spring 會拋出其內(nèi)置特定的異常。如上面 SQL 語句異常將會拋出 BadSqlGrammarException。除了這個異常之外，Spring 還定義很多數(shù)據(jù)庫異常。

每個 Spring 數(shù)據(jù)庫異常的基類都是 DataAccessException。由于 DataAccessException 繼承自 RuntimeException，所以在這類異常無需強制捕獲。

在 Spring 中使用 SQLExceptionTranslator 進行異常轉(zhuǎn)換，默認的轉(zhuǎn)換規(guī)則會根據(jù) SQLException.getErrorCode 返回的錯誤碼進行相應的轉(zhuǎn)換。

下面我們從源碼分析轉(zhuǎn)換過程。

實現(xiàn)細節(jié)

調(diào)試 JdbcTemplate 的源碼。

可以看到這里捕獲了 SQLException，轉(zhuǎn)換之后再將其拋出。

整個轉(zhuǎn)換過程，最后交給 SQLExceptionTranslator 進行轉(zhuǎn)換。

首先我們查看 SQLExceptionTranslator 類圖。

可以看到其實現(xiàn)了一個抽象類以及三個子類。

抽象類中會首先會使用子類轉(zhuǎn)換，若未能轉(zhuǎn)換成功，將會啟動 fallback機制，再次轉(zhuǎn)換，作為兜底。

接著我們先看下三個子類的區(qū)別。

SQLErrorCodeSQLExceptionTranslator:

默認轉(zhuǎn)換類主要根據(jù) SQLException.getErrorCode 進行轉(zhuǎn)換。默認使用 SQLExceptionSubclassTranslator 作為 fallback 對象。

SQLExceptionSubclassTranslator：

基于 JDBC 的 SQLException 標準子類判斷，如 java.sql.SQLTransientException。使用 SQLStateSQLExceptionTranslator 作為 fallback 對象。

SQLStateSQLExceptionTranslator：

基于 SQLException.getSQLState 規(guī)則判斷。

下面分析 SQLErrorCodeSQLExceptionTranslator ，其他兩個比較類似，同學們可以自己看源碼分析。

SQLErrorCodeSQLExceptionTranslator 轉(zhuǎn)換器主要根據(jù) SQLException.getErrorCode 進行判斷。Spring 默認在 org/springframework/jdbc/support/sql-error-codes.xml 歸納不同數(shù)據(jù)庫廠商相關錯誤碼。該配置文件會在第一次發(fā)生 SQL 異常時由 SQLErrorCodesFactory 進行加載，最后生成 SQLErrorCodes。

另外在 SQLErrorCodes 提供擴展方法，可以根據(jù)錯誤碼轉(zhuǎn)換成自定義的異常。

最后查看 SQLErrorCodeSQLExceptionTranslator 里的轉(zhuǎn)換方法。

前三個方法是 Spring 留下擴展方法，可以根據(jù)自己需求分別擴展。若都沒有實現(xiàn)，將會根據(jù)錯誤碼判斷轉(zhuǎn)換成具體的異常。

自定義異常轉(zhuǎn)換

上面說到 Spring 總共給我們留下三處擴展點。

繼承 SQLErrorCodeSQLExceptionTranslator，重寫 customTranslate。繼承 SQLExceptionTranslator，重寫 translate，然后在 sql-error-codes.xml注入。使用 SQLErrorCodes#customTranslations ，然后在 sql-error-codes.xml 配置相關錯誤碼轉(zhuǎn)換的規(guī)則。

第三種方式改動最小，比較簡單。首先在 classpath 下生成 sql-error-codes.xml，復制原有配置，最后配置 customTranslations 。