javascript
Spring Boot 中使用 @Transactional 注解配置事务管理
From: https://blog.csdn.net/nextyu/article/details/78669997
事務管理是應用系統開發中必不可少的一部分。Spring 為事務管理提供了豐富的功能支持。Spring 事務管理分為編程式和聲明式的兩種方式。編程式事務指的是通過編碼方式實現事務;聲明式事務基于 AOP,將具體業務邏輯與事務處理解耦。聲明式事務管理使業務代碼邏輯不受污染, 因此在實際使用中聲明式事務用的比較多。聲明式事務有兩種方式,一種是在配置文件(xml)中做相關的事務規則聲明,另一種是基于 @Transactional 注解的方式。本文將著重介紹基于 @Transactional 注解的事務管理。
需要明確幾點:
??? 默認配置下 Spring 只會回滾運行時、未檢查異常(繼承自 RuntimeException 的異常)或者 Error。參考這里
??? @Transactional 注解只能應用到 public 方法才有效。參考這里 Method visibility and @Transactional
以下的示例使用的是 mybatis,所以 spring boot 會自動配置一個 DataSourceTransactionManager,我們只需在方法(或者類)加上 @Transactional 注解,就自動納入 Spring 的事務管理了。
簡單的使用方法
只需在方法加上 @Transactional 注解就可以了。
如下有一個保存用戶的方法,加入 @Transactional 注解,使用默認配置,拋出異常之后,事務會自動回滾,數據不會插入到數據庫。
@Transactional
@Override
public void save() {
??? User user = new User("服部半藏");
??? userMapper.insertSelective(user);
??? if (true) {
??????? throw new RuntimeException("save 拋異常了");
??? }
}
我們可以從日志里面看出這些信息
TIM截圖20171129135813
@Transactional 注解的屬性介紹
下面分別介紹一下 @Transactional 的幾個屬性。
value 和 transactionManager 屬性
它們兩個是一樣的意思。當配置了多個事務管理器時,可以使用該屬性指定選擇哪個事務管理器。
propagation 屬性
事務的傳播行為,默認值為 Propagation.REQUIRED。
可選的值有:
??? Propagation.REQUIRED
??? 如果當前存在事務,則加入該事務,如果當前不存在事務,則創建一個新的事務。
??? Propagation.SUPPORTS
??? 如果當前存在事務,則加入該事務;如果當前不存在事務,則以非事務的方式繼續運行。
??? Propagation.MANDATORY
??? 如果當前存在事務,則加入該事務;如果當前不存在事務,則拋出異常。
??? Propagation.REQUIRES_NEW
??? 重新創建一個新的事務,如果當前存在事務,暫停當前的事務。
??? Propagation.NOT_SUPPORTED
??? 以非事務的方式運行,如果當前存在事務,暫停當前的事務。
??? Propagation.NEVER
??? 以非事務的方式運行,如果當前存在事務,則拋出異常。
??? Propagation.NESTED
??? 和 Propagation.REQUIRED 效果一樣。
這些概念理解起來實在是有點兒抽象,后文會用代碼示例解釋說明。
isolation 屬性
事務的隔離級別,默認值為 Isolation.DEFAULT。
可選的值有:
??? Isolation.DEFAULT
??? 使用底層數據庫默認的隔離級別。
??? Isolation.READ_UNCOMMITTED
??? Isolation.READ_COMMITTED
??? Isolation.REPEATABLE_READ
??? Isolation.SERIALIZABLE
timeout 屬性
事務的超時時間,默認值為-1。如果超過該時間限制但事務還沒有完成,則自動回滾事務。
readOnly 屬性
指定事務是否為只讀事務,默認值為 false;為了忽略那些不需要事務的方法,比如讀取數據,可以設置 read-only 為 true。
rollbackFor 屬性
用于指定能夠觸發事務回滾的異常類型,可以指定多個異常類型。
noRollbackFor 屬性
拋出指定的異常類型,不回滾事務,也可以指定多個異常類型。
@Transactional 的 propagation 屬性代碼示例
比如如下代碼,save 方法首先調用了 method1 方法,然后拋出了異常,就會導致事務回滾,如下兩條數據都不會插入數據庫。
@Transactional(propagation = Propagation.REQUIRED)
@Override
public void save() {
??? method1();
??? User user = new User("服部半藏");
??? userMapper.insertSelective(user);
??? if (true) {
??????? throw new RuntimeException("save 拋異常了");
??? }
}
public void method1() {
??? User user = new User("宮本武藏");
??? userMapper.insertSelective(user);
}
現在有需求如下,就算 save 方法的后面拋異常了,也不能影響 method1 方法的數據插入。或許很多人的想法如下,給 method1 頁加入一個新的事務,這樣 method1 就會在這個新的事務中執行,原來的事務不會影響到新的事務。比如 method1 方法上面再加入注解 @Transactional,設置 propagation 屬性為 Propagation.REQUIRES_NEW,代碼如下。
@Transactional(propagation = Propagation.REQUIRED)
@Override
public void save() {
??? method1();
??? User user = new User("服部半藏");
??? userMapper.insertSelective(user);
??? if (true) {
??????? throw new RuntimeException("save 拋異常了");
??? }
}
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void method1() {
??? User user = new User("宮本武藏");
??? userMapper.insertSelective(user);
}
?
運行之后,發現然并卵,數據也是沒有插入數據庫。怎么肥四,看起來很不科學。我們先來看看日志內容。
TIM截圖20171129150737
從日志內容可以看出,其實兩個方法都是處于同一個事務中,method1 方法并沒有創建一個新的事務。
這就得看看 Spring 官方文檔了。
??? In proxy mode (which is the default), only external method calls coming in through the proxy are intercepted. This means that self-invocation, in effect, a method within the target object calling another method of the target object, will not lead to an actual transaction at runtime even if the invoked method is marked with @Transactional.
大概意思:在默認的代理模式下,只有目標方法由外部調用,才能被 Spring 的事務攔截器攔截。在同一個類中的兩個方法直接調用,是不會被 Spring 的事務攔截器攔截,就像上面的 save 方法直接調用了同一個類中的 method1方法,method1 方法不會被 Spring 的事務攔截器攔截。可以使用 AspectJ 取代 Spring AOP 代理來解決這個問題,但是這里暫不討論。
為了解決這個問題,我們可以新建一個類。
@Service
public class OtherServiceImpl implements OtherService {
??? @Autowired
??? private UserMapper userMapper;
??? @Transactional(propagation = Propagation.REQUIRES_NEW)
??? @Override
??? public void method1() {
??????? User user = new User("風魔小太郎");
??????? userMapper.insertSelective(user);
??? }
}
?
然后在 save 方法中調用 otherService.method1 方法
@Autowired
private OtherService otherService;
@Transactional(propagation = Propagation.REQUIRED)
@Override
public void save() {
??? otherService.method1();
??? User user = new User("服部半藏");
??? userMapper.insertSelective(user);
??? if (true) {
??????? throw new RuntimeException("save 拋異常了");
??? }
}
??
這下,otherService.method1 方法的數據插入成功,save 方法的數據未插入,事務回滾。
繼續看一下日志內容
TIM截圖20171129153731
從日志可以看出,首先創建了 save 方法的事務,由于 otherService.method1 方法的 @Transactional 的 propagation 屬性為 Propagation.REQUIRES_NEW ,所以接著暫停了 save 方法的事務,重新創建了 otherService.method1 方法的事務,接著 otherService.method1 方法的事務提交,接著 save 方法的事務回滾。這就印證了只有目標方法由外部調用,才能被 Spring 的事務攔截器攔截。
還有幾個示例如下。
接著把 save 方法的 @Transactional 注解去掉,otherService.method1 的 @Transactional 注解保持不變,從日志就可以看出,只會創建一個 otherService.method1 方法的事務,兩條數據都會插入。
@Autowired
private OtherService otherService;
//??? @Transactional(propagation = Propagation.REQUIRED)
@Override
public void save() {
??? otherService.method1();
??? User user = new User("服部半藏");
??? userMapper.insertSelective(user);
??? if (true) {
??????? throw new RuntimeException("save 拋異常了");
??? }
}
?
接著把 save 方法的 @Transactional 注解去掉,save 方法改為調用內部的 method1 方法,從日志就可以看出,完全沒有創建任何事務,兩條數據都會插入。
//??? @Transactional(propagation = Propagation.REQUIRED)
@Override
public void save() {
??? method1();
??? User user = new User("服部半藏");
??? userMapper.insertSelective(user);
??? if (true) {
??????? throw new RuntimeException("save 拋異常了");
??? }
}
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void method1() {
??? User user = new User("宮本武藏");
??? userMapper.insertSelective(user);
}
?
這樣,其他的幾個 propagation 屬性值也就比較好理解了。
@Transactional 事務實現機制
在應用系統調用聲明了 @Transactional 的目標方法時,Spring Framework 默認使用 AOP 代理,在代碼運行時生成一個代理對象,根據 @Transactional 的屬性配置信息,這個代理對象決定該聲明 @Transactional 的目標方法是否由攔截器 TransactionInterceptor 來使用攔截,在 TransactionInterceptor 攔截時,會在目標方法開始執行之前創建并加入事務,并執行目標方法的邏輯, 最后根據執行情況是否出現異常,利用抽象事務管理器 AbstractPlatformTransactionManager 操作數據源 DataSource 提交或回滾事務。
Spring AOP 代理有 CglibAopProxy 和 JdkDynamicAopProxy 兩種,以 CglibAopProxy 為例,對于 CglibAopProxy,需要調用其內部類的 DynamicAdvisedInterceptor 的 intercept 方法。對于 JdkDynamicAopProxy,需要調用其 invoke 方法。
Spring-transaction-mechanis
正如上文提到的,事務管理的框架是由抽象事務管理器 AbstractPlatformTransactionManager 來提供的,而具體的底層事務處理實現,由 PlatformTransactionManager 的具體實現類來實現,如事務管理器 DataSourceTransactionManager。不同的事務管理器管理不同的數據資源 DataSource,比如 DataSourceTransactionManager 管理 JDBC 的 Connection。
Spring-TransactionManager-hierarchy-subtypes
源碼地址
??? https://github.com/nextyu/spring-transaction-demo
參考資料
??? Spring 官方文檔
??? Spring boot 官方文檔
??? Mybatis
??? 資料
??? 資料
??? 資料
結語
由于本人知識和能力有限,文中如有沒說清楚的地方,希望大家能在評論區指出,以幫助我將博文寫得更好。
?
總結
以上是生活随笔為你收集整理的Spring Boot 中使用 @Transactional 注解配置事务管理的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: EIGRP个人学习笔记
- 下一篇: mybatis源码学习