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

如果需要處理特定 SQL 異常，比如 SQL 語(yǔ)句錯(cuò)誤，這個(gè)時(shí)候我們應(yīng)該怎么辦？

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

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

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

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

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

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

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

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

每個(gè) Spring 數(shù)據(jù)庫(kù)異常的基類(lèi)都是 DataAccessException。由于 DataAccessException 繼承自 RuntimeException，所以在這類(lèi)異常無(wú)需強(qiáng)制捕獲。

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

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

實(shí)現(xiàn)細(xì)節(jié)

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

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

整個(gè)轉(zhuǎn)換過(guò)程，最后交給 SQLExceptionTranslator 進(jìn)行轉(zhuǎn)換。

首先我們查看 SQLExceptionTranslator 類(lèi)圖。

可以看到其實(shí)現(xiàn)了一個(gè)抽象類(lèi)以及三個(gè)子類(lèi)。

抽象類(lèi)中會(huì)首先會(huì)使用子類(lèi)轉(zhuǎn)換，若未能轉(zhuǎn)換成功，將會(huì)啟動(dòng) fallback機(jī)制，再次轉(zhuǎn)換，作為兜底。

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

SQLErrorCodeSQLExceptionTranslator:

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

SQLExceptionSubclassTranslator：

基于 JDBC 的 SQLException 標(biāo)準(zhǔn)子類(lèi)判斷，如 java.sql.SQLTransientException。使用 SQLStateSQLExceptionTranslator 作為 fallback 對(duì)象。

SQLStateSQLExceptionTranslator：

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

下面分析 SQLErrorCodeSQLExceptionTranslator ，其他兩個(gè)比較類(lèi)似，同學(xué)們可以自己看源碼分析。

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

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

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

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

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

上面說(shuō)到 Spring 總共給我們留下三處擴(kuò)展點(diǎn)。

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

第三種方式改動(dòng)最小，比較簡(jiǎn)單。首先在 classpath 下生成 sql-error-codes.xml，復(fù)制原有配置，最后配置 customTranslations 。

這里需要注意的是，需要轉(zhuǎn)化的異常類(lèi)型必須為 DataAccessException 子類(lèi)。下面面我們自定義一個(gè)異常。

總結(jié)

Spirng 異常處理將 SQL 異常轉(zhuǎn)化成內(nèi)置異常，屏蔽不同數(shù)據(jù)庫(kù)返回碼不一致的帶來(lái)的問(wèn)題。

最后總結(jié)本文的知識(shí)點(diǎn)，希望幫助到大家。

幫助

Handling SQLExceptions