源碼解析Spring 數(shù)據(jù)庫異常抽理知識點(diǎn)總結(jié)
數(shù)據(jù)庫為:H2
如果需要處理特定 SQL 異常,比如 SQL 語句錯(cuò)誤,這個(gè)時(shí)候我們應(yīng)該怎么辦?
查看 SQLException 源碼,我們可以發(fā)現(xiàn)兩個(gè)重要的方法。
SQLException.getErrorCode:返回?cái)?shù)據(jù)庫特定的錯(cuò)誤碼,由數(shù)據(jù)庫廠商制定,不同廠商錯(cuò)誤碼不同。如重復(fù)主鍵錯(cuò)誤碼在 MySQL 中是 1062,而在 Oracle 中卻是 1。
SQLException.getSQLState:返回 XOPEN 或 SQL:2003 制定的錯(cuò)誤碼規(guī)范。數(shù)據(jù)庫廠商會將不同錯(cuò)誤消息映射成同一個(gè)錯(cuò)誤碼
所以我們可以根據(jù) SQLException.getErrorCode 處理相應(yīng)的數(shù)據(jù)庫異常。
由于數(shù)據(jù)庫廠商錯(cuò)誤碼不相同,這就導(dǎo)致如果我們更換數(shù)據(jù)庫,上面判斷邏輯就必須重寫。
下面我們使用 Spring 操作數(shù)據(jù)庫。
Spring 操作數(shù)據(jù)庫
使用 Spring 之后,我們不再需要強(qiáng)制捕獲異常。如果 SQL 語句運(yùn)行存在異常,Spring 會拋出其內(nèi)置特定的異常。如上面 SQL 語句異常將會拋出 BadSqlGrammarException。除了這個(gè)異常之外,Spring 還定義很多數(shù)據(jù)庫異常。
每個(gè) Spring 數(shù)據(jù)庫異常的基類都是 DataAccessException。由于 DataAccessException 繼承自 RuntimeException,所以在這類異常無需強(qiáng)制捕獲。
在 Spring 中使用 SQLExceptionTranslator 進(jìn)行異常轉(zhuǎn)換,默認(rèn)的轉(zhuǎn)換規(guī)則會根據(jù) SQLException.getErrorCode 返回的錯(cuò)誤碼進(jìn)行相應(yīng)的轉(zhuǎn)換。
下面我們從源碼分析轉(zhuǎn)換過程。
實(shí)現(xiàn)細(xì)節(jié)
調(diào)試 JdbcTemplate 的源碼。
可以看到這里捕獲了 SQLException,轉(zhuǎn)換之后再將其拋出。
整個(gè)轉(zhuǎn)換過程,最后交給 SQLExceptionTranslator 進(jìn)行轉(zhuǎn)換。
首先我們查看 SQLExceptionTranslator 類圖。
可以看到其實(shí)現(xiàn)了一個(gè)抽象類以及三個(gè)子類。
抽象類中會首先會使用子類轉(zhuǎn)換,若未能轉(zhuǎn)換成功,將會啟動(dòng) fallback機(jī)制,再次轉(zhuǎn)換,作為兜底。
接著我們先看下三個(gè)子類的區(qū)別。
SQLErrorCodeSQLExceptionTranslator:
默認(rèn)轉(zhuǎn)換類主要根據(jù) SQLException.getErrorCode 進(jìn)行轉(zhuǎn)換。默認(rèn)使用 SQLExceptionSubclassTranslator 作為 fallback 對象。
SQLExceptionSubclassTranslator:
基于 JDBC 的 SQLException 標(biāo)準(zhǔn)子類判斷,如 java.sql.SQLTransientException。使用 SQLStateSQLExceptionTranslator 作為 fallback 對象。
SQLStateSQLExceptionTranslator:
基于 SQLException.getSQLState 規(guī)則判斷。
下面分析 SQLErrorCodeSQLExceptionTranslator ,其他兩個(gè)比較類似,同學(xué)們可以自己看源碼分析。
SQLErrorCodeSQLExceptionTranslator 轉(zhuǎn)換器主要根據(jù) SQLException.getErrorCode 進(jìn)行判斷。Spring 默認(rèn)在 org/springframework/jdbc/support/sql-error-codes.xml 歸納不同數(shù)據(jù)庫廠商相關(guān)錯(cuò)誤碼。該配置文件會在第一次發(fā)生 SQL 異常時(shí)由 SQLErrorCodesFactory 進(jìn)行加載,最后生成 SQLErrorCodes。
另外在 SQLErrorCodes 提供擴(kuò)展方法,可以根據(jù)錯(cuò)誤碼轉(zhuǎn)換成自定義的異常。
最后查看 SQLErrorCodeSQLExceptionTranslator 里的轉(zhuǎn)換方法。
前三個(gè)方法是 Spring 留下擴(kuò)展方法,可以根據(jù)自己需求分別擴(kuò)展。若都沒有實(shí)現(xiàn),將會根據(jù)錯(cuò)誤碼判斷轉(zhuǎn)換成具體的異常。
自定義異常轉(zhuǎn)換
上面說到 Spring 總共給我們留下三處擴(kuò)展點(diǎn)。
繼承 SQLErrorCodeSQLExceptionTranslator,重寫 customTranslate。繼承 SQLExceptionTranslator,重寫 translate,然后在 sql-error-codes.xml注入。使用 SQLErrorCodes#customTranslations ,然后在 sql-error-codes.xml 配置相關(guān)錯(cuò)誤碼轉(zhuǎn)換的規(guī)則。
第三種方式改動(dòng)最小,比較簡單。首先在 classpath 下生成 sql-error-codes.xml,復(fù)制原有配置,最后配置 customTranslations 。
這里需要注意的是,需要轉(zhuǎn)化的異常類型必須為 DataAccessException 子類。下面面我們自定義一個(gè)異常。
總結(jié)
Spirng 異常處理將 SQL 異常轉(zhuǎn)化成內(nèi)置異常,屏蔽不同數(shù)據(jù)庫返回碼不一致的帶來的問題。
最后總結(jié)本文的知識點(diǎn),希望幫助到大家。
幫助
相關(guān)文章
IDEA設(shè)置生成帶注釋的getter和setter的圖文教程
通常我們用idea默認(rèn)生成的getter和setter方法是不帶注釋的,當(dāng)然,我們同樣可以設(shè)置idea像MyEclipse一樣生成帶有Javadoc的模板,具體設(shè)置方法,大家參考下本文2018-05-05SpringBoot通過ThreadLocal實(shí)現(xiàn)登錄攔截詳解流程
這篇文章主要介紹了SpringBoot(HandlerInterceptor)+ThreadLocal實(shí)現(xiàn)登錄攔截,具有很好的參考價(jià)值,希望對大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-05-05SpringBoot通過源碼探究靜態(tài)資源的映射規(guī)則實(shí)現(xiàn)
這篇文章主要介紹了SpringBoot通過源碼探究靜態(tài)資源的映射規(guī)則實(shí)現(xiàn),文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-05-05