spring的@Transactional註解詳細用法

阿新 • • 發佈：2021-07-20

事務管理對於企業應用來說是至關重要的，即使出現異常情況，它也可以保證資料的一致性。
Spring Framework對事務管理提供了一致的抽象，其特點如下：

為不同的事務API提供一致的程式設計模型，比如JTA(Java Transaction API), JDBC, Hibernate, JPA(Java Persistence API和JDO(Java Data Objects)
支援宣告式事務管理，特別是基於註解的宣告式事務管理，簡單易用
提供比其他事務API如JTA更簡單的程式設計式事務管理API
與spring資料訪問抽象的完美整合

事務管理方式

spring支援程式設計式事務管理和宣告式事務管理兩種方式。

程式設計式事務管理使用TransactionTemplate或者直接使用底層的PlatformTransactionManager。對於程式設計式事務管理，spring推薦使用TransactionTemplate。

宣告式事務管理建立在AOP之上的。其本質是對方法前後進行攔截，然後在目標方法開始之前建立或者加入一個事務，在執行完目標方法之後根據執行情況提交或者回滾事務。宣告式事務最大的優點就是不需要通過程式設計的方式管理事務，這樣就不需要在業務邏輯程式碼中摻雜事務管理的程式碼，只需在配置檔案中做相關的事務規則宣告(或通過基於@Transactional註解的方式)，便可以將事務規則應用到業務邏輯中。

顯然宣告式事務管理要優於程式設計式事務管理，這正是spring倡導的非侵入式的開發方式。宣告式事務管理使業務程式碼不受汙染，一個普通的POJO物件，只要加上註解就可以獲得完全的事務支援。和程式設計式事務相比，宣告式事務唯一不足地方是，後者的最細粒度只能作用到方法級別，無法做到像程式設計式事務那樣可以作用到程式碼塊級別。但是即便有這樣的需求，也存在很多變通的方法，比如，可以將需要進行事務管理的程式碼塊獨立為方法等等。

宣告式事務管理也有兩種常用的方式，一種是基於tx和aop名字空間的xml配置檔案，另一種就是基於@Transactional註解。顯然基於註解的方式更簡單易用，更清爽。

自動提交(AutoCommit)與連線關閉時的是否自動提交

自動提交

預設情況下，資料庫處於自動提交模式。每一條語句處於一個單獨的事務中，在這條語句執行完畢時，如果執行成功則隱式的提交事務，如果
執行失敗則隱式的回滾事務。

有些資料連線池提供了關閉事務自動提交的設定，最好在設定連線池時就將其關閉。但C3P0沒有提供這一特性，只能依靠spring來設定。
因為JDBC規範規定，當連線物件建立時應該處於自動提交模式，這是跨DBMS的預設值，如果需要,必須顯式的關閉自動提交。C3P0遵守這一規範，讓客戶程式碼來顯式的設定需要的提交模式。

連線關閉時的是否自動提交

當一個連線關閉時，如果有未提交的事務應該如何處理？JDBC規範沒有提及，C3P0預設的策略是回滾任何未提交的事務。這是一個正確的策略，但JDBC驅動提供商之間對此問題並沒有達成一致。
C3P0的autoCommitOnClose屬性預設是false,沒有十分必要不要動它。或者可以顯式的設定此屬性為false，這樣會更明確。

基於註解的宣告式事務管理配置
spring-servlet.xml

1 <!-- transaction support-->
2 <!-- PlatformTransactionMnager -->
3 <bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
4     <property name="dataSource" ref="dataSource" />
5 </bean>
6 <!-- enable transaction annotation support -->
7 <tx:annotation-driven transaction-manager="txManager" />

還要在spring-servlet.xml中新增tx名字空間

 1 ...
 2     xmlns:tx="http://www.springframework.org/schema/tx"
 3     xmlns:aop="http://www.springframework.org/schema/aop"
 4     xsi:schemaLocation="
 5     ...
 6  
 7 http://www.springframework.org/schema/tx
 8  
 9  
10 http://www.springframework.org/schema/tx/spring-tx.xsd
11  
12     ...

MyBatis自動參與到spring事務管理中，無需額外配置，只要org.mybatis.spring.SqlSessionFactoryBean引用的資料來源與DataSourceTransactionManager引用的資料來源一致即可，否則事務管理會不起作用。

另外需要下載依賴包aopalliance.jar放置到WEB-INF/lib目錄下。否則spring初始化時會報異常
java.lang.NoClassDefFoundError: org/aopalliance/intercept/MethodInterceptor

spring事務特性

TransactionDefinition介面定義以下特性：

事務隔離級別

隔離級別是指若干個併發的事務之間的隔離程度。TransactionDefinition 介面中定義了五個表示隔離級別的常量：

TransactionDefinition.ISOLATION_DEFAULT：這是預設值，表示使用底層資料庫的預設隔離級別。對大部分資料庫而言，通常這值就是TransactionDefinition.ISOLATION_READ_COMMITTED。
TransactionDefinition.ISOLATION_READ_UNCOMMITTED：該隔離級別表示一個事務可以讀取另一個事務修改但還沒有提交的資料。該級別不能防止髒讀，不可重複讀和幻讀，因此很少使用該隔離級別。比如PostgreSQL實際上並沒有此級別。
TransactionDefinition.ISOLATION_READ_COMMITTED：該隔離級別表示一個事務只能讀取另一個事務已經提交的資料。該級別可以防止髒讀，這也是大多數情況下的推薦值。
TransactionDefinition.ISOLATION_REPEATABLE_READ：該隔離級別表示一個事務在整個過程中可以多次重複執行某個查詢，並且每次返回的記錄都相同。該級別可以防止髒讀和不可重複讀。
TransactionDefinition.ISOLATION_SERIALIZABLE：所有的事務依次逐個執行，這樣事務之間就完全不可能產生干擾，也就是說，該級別可以防止髒讀、不可重複讀以及幻讀。但是這將嚴重影響程式的效能。通常情況下也不會用到該級別。

事務傳播行為

所謂事務的傳播行為是指，如果在開始當前事務之前，一個事務上下文已經存在，此時有若干選項可以指定一個事務性方法的執行行為。在TransactionDefinition定義中包括瞭如下幾個表示傳播行為的常量：

TransactionDefinition.PROPAGATION_REQUIRED：如果當前存在事務，則加入該事務；如果當前沒有事務，則建立一個新的事務。這是預設值。
TransactionDefinition.PROPAGATION_REQUIRES_NEW：建立一個新的事務，如果當前存在事務，則把當前事務掛起。
TransactionDefinition.PROPAGATION_SUPPORTS：如果當前存在事務，則加入該事務；如果當前沒有事務，則以非事務的方式繼續執行。
TransactionDefinition.PROPAGATION_NOT_SUPPORTED：以非事務方式執行，如果當前存在事務，則把當前事務掛起。
TransactionDefinition.PROPAGATION_NEVER：以非事務方式執行，如果當前存在事務，則丟擲異常。
TransactionDefinition.PROPAGATION_MANDATORY：如果當前存在事務，則加入該事務；如果當前沒有事務，則丟擲異常。
TransactionDefinition.PROPAGATION_NESTED：如果當前存在事務，則建立一個事務作為當前事務的巢狀事務來執行；如果當前沒有事務，則該取值等價於TransactionDefinition.PROPAGATION_REQUIRED。

事務超時

所謂事務超時，就是指一個事務所允許執行的最長時間，如果超過該時間限制但事務還沒有完成，則自動回滾事務。在 TransactionDefinition 中以 int 的值來表示超時時間，其單位是秒。

預設設定為底層事務系統的超時值，如果底層資料庫事務系統沒有設定超時值，那麼就是none，沒有超時限制。

事務只讀屬性

只讀事務用於客戶程式碼只讀但不修改資料的情形，只讀事務用於特定情景下的優化，比如使用Hibernate的時候。
預設為讀寫事務。

spring事務回滾規則

指示spring事務管理器回滾一個事務的推薦方法是在當前事務的上下文內丟擲異常。spring事務管理器會捕捉任何未處理的異常，然後依據規則決定是否回滾丟擲異常的事務。

預設配置下，spring只有在丟擲的異常為執行時unchecked異常時才回滾該事務，也就是丟擲的異常為RuntimeException的子類(Errors也會導致事務回滾)，而丟擲checked異常則不會導致事務回滾。
可以明確的配置在丟擲那些異常時回滾事務，包括checked異常。也可以明確定義那些異常丟擲時不回滾事務。

還可以程式設計性的通過setRollbackOnly()方法來指示一個事務必須回滾，在呼叫完setRollbackOnly()後你所能執行的唯一操作就是回滾。

@Transactional註解

@Transactional屬性


屬性	型別	描述
value	String	可選的限定描述符，指定使用的事務管理器
propagation	enum: Propagation	可選的事務傳播行為設定
isolation	enum: Isolation	可選的事務隔離級別設定
readOnly	boolean	讀寫或只讀事務，預設讀寫
timeout	int (in seconds granularity)	事務超時時間設定
rollbackFor	Class物件陣列，必須繼承自Throwable	導致事務回滾的異常類陣列
rollbackForClassName	類名陣列，必須繼承自Throwable	導致事務回滾的異常類名字陣列
noRollbackFor	Class物件陣列，必須繼承自Throwable	不會導致事務回滾的異常類陣列
noRollbackForClassName	類名陣列，必須繼承自Throwable	不會導致事務回滾的異常類名字陣列

用法

1. 在需要事務管理的地方加@Transactional 註解。@Transactional 註解可以被應用於介面定義和介面方法、類定義和類的 public 方法上。

2.@Transactional註解只能應用到 public 可見度的方法上。如果你在 protected、private 或者 package-visible 的方法上使用 @Transactional 註解，它也不會報錯，但是這個被註解的方法將不會展示已配置的事務設定。

3. 注意僅僅 @Transactional 註解的出現不足於開啟事務行為，它僅僅是一種元資料。必須在配置檔案中使用配置元素，才真正開啟了事務行為。

4. 通過元素的 "proxy-target-class" 屬性值來控制是基於介面的還是基於類的代理被建立。如果 "proxy-target-class" 屬值被設定為 "true"，那麼基於類的代理將起作用（這時需要CGLIB庫cglib.jar在CLASSPATH中）。如果 "proxy-target-class" 屬值被設定為 "false" 或者這個屬性被省略，那麼標準的JDK基於介面的代理將起作用。

標準的JDK基於介面的代理將起作用-->
proxy-target-class="false"/>

基於類的代理將起作用 ,同時 cglib.jar必須在CLASSPATH中
proxy-target-class="true"/>
-->

非JTA事務（即非分散式事務），事務配置的時候，需要指定dataSource屬性（非分散式事務，事務是在資料庫建立的連結上開啟。）-->

JTA事務（非分散式事務），事務配置的時候，不能指定dataSource屬性（分散式事務，是有全域性事務來管理資料庫連結的）-->

註解@Transactional cglib與java動態代理最大區別是代理目標物件不用實現介面,那麼註解要是寫到介面方法上，要是使用cglib代理，這是註解事物就失效了，為了保持相容註解最好都寫到實現類方法上。

5.Spring團隊建議在具體的類（或類的方法）上使用 @Transactional 註解，而不要使用在類所要實現的任何介面上。在介面上使用 @Transactional 註解，只能當你設定了基於介面的代理時它才生效。因為註解是不能繼承的，這就意味著如果正在使用基於類的代理時，那麼事務的設定將不能被基於類的代理所識別，而且物件也將不會被事務代理所包裝。

6. @Transactional 的事務開啟，或者是基於介面的或者是基於類的代理被建立。所以在同一個類中一個方法呼叫另一個方法有事務的方法，事務是不會起作用的。

public interface PersonService {
//刪除指定id的person
public void delete(Integer personid) ;

//刪除指定id的person,flag
public void delete(Integer personid,boolean flag) ;
}

public class PersonServiceBean implements PersonService {
private JdbcTemplate jdbcTemplate;

public void delete(Integer personid){
try{
this.delete(personid,true)
System.out.println("delete success");
}catch(Exception e){
System.out.println("delete failed");
}
}

@Transactional
//此時，事務根本就沒有開啟, 即資料庫會預設提交該操作，即記錄別刪除掉public void delete(Integer personid,boolean flag){
if(flag == ture){
jdbcTemplate.update("delete from person where id=?", new Object[]{personid},
new int[]{java.sql.Types.INTEGER});
throw new RuntimeException("執行期例外");
}
}
}

public class PersonServiceBeanTest{
PersonService ps = new PersonServiceBean ();
ps.delete(5);
}

7. Spring使用宣告式事務處理，預設情況下，如果被註解的資料庫操作方法中發生了unchecked異常，所有的資料庫操作將rollback；如果發生的異常是checked異常，預設情況下資料庫操作還是會提交的。

-----------------------------------------------------------------------------------------------------------------------------------------------
public interface PersonService {
//刪除指定id的person
public void delete(Integer personid) ;

//獲取person
public Person getPerson(Integer personid);
}

//PersonServiceBean 實現了PersonService 介面，則基於介面的還是基於類的代理都可以實現事務
@Transactionalpublic class PersonServiceBean implements PersonService {
private JdbcTemplate jdbcTemplate;

//發生了unchecked異常,事務回滾,@Transactional
public void delete(Integer personid){
jdbcTemplate.update("delete from person where id=?", new Object[]{personid},
new int[]{java.sql.Types.INTEGER});
throw new RuntimeException("執行期例外");
}
}

---------------------------------------------------------------------------------------------------------------------------------------------------
public interface PersonService {
//刪除指定id的person
public void delete(Integer personid) throws Exception;

//獲取person
public Person getPerson(Integer personid);
}

@Transactional
public class PersonServiceBean implements PersonService {

//發生了checked異常,事務不回滾,即資料庫記錄仍能被刪除，
//checked的例外，需要我們在外部用try/catch語法對呼叫該方法的地方進行包含@Transactional
public void delete(Integer personid)throws Exception{
jdbcTemplate.update("delete from person where id=?", new Object[]{personid},
new int[]{java.sql.Types.INTEGER});
throw new Exception("執行期例外");
}

}
---------------------------------------------------------------------------------------------------------------------------------------------------
但是，對於checked這種例外，預設情況下它是不會進行事務回滾的，但是如果我們需要它進行事務回滾，這時候可以在delete方法上通過@Transaction這個註解來修改它的行為。

@Transactional
public class PersonServiceBean implements PersonService {

@Transactional(rollbackFor=Exception.class)
//rollbackFor這屬性指定了，既使你出現了checked這種例外，那麼它也會對事務進行回滾
public void delete(Integer personid) throws Exception{
jdbcTemplate.update("delete from person where id=?", new Object[]{personid},
new int[]{java.sql.Types.INTEGER});
throw new Exception("執行期例外");
}
}
---------------------------------------------------------------------------------------------------------------------------------------------------

在PersonServiceBean這個業務bean裡面，有一些事務是不需要事務管理的，好比說獲取資料的getPersons方法，getPerson方法。因為@Transactional 放在了類的上面。

此時，可以採用propagation這個事務屬性@Transactional(propagation=Propagation.NOT_SUPPORTED)，propagation這個屬性指定了事務傳播行為，我們可以指定它不支援事務，當我們這麼寫了之後，Spring容器在getPersons方法執行前就不會開啟事務.

@Transactional
public class PersonServiceBean implements PersonService {

@Transactional(propagation=Propagation.NOT_SUPPORTED)
//則此方法就不會開啟事務了
public Person getPerson(Integer personid)
{
}
}

spring的@Transactional註解詳細用法

spring的@Transactional註解詳細用法

@Transactional註解詳細用法

Spring @Transactional註解失效解決方案

Spring條件註解用法案例分析

spring註解@Import用法詳解

@Query註解的用法(Spring Data JPA)

Spring Boot 中使用 @Transactional 註解配置事務管理

spring-事務實現和@Transactional註解分析

Spring基於註解方式實現屬性注入（超詳細）

Spring@Import註解的三種用法

用 Spring 的 @Transactional 註解控制事務有哪些不生效的場景？

spring的@Transactional註解

Spring Boot註解學習之@SpringBootApplication(一)

Spring Boot註解學習之@SpringBootApplication(二)

記一次Spring @Transactional失效的排查過程

[純乾貨] 如何用Spring 原生註解快速實現策略模式+工廠模式

Spring系列十一：Spring @Configuration註解

Spring AOP - 註解方式使用介紹（長文詳解）

Spring 常用註解大全

Spring一些註解配置和類的解讀

spring的@Transactional註解詳細用法

相關推薦