SpringBoot - @Transactional注解详解

向右看齐 2023-10-12 16:43 13阅读 0赞

#### 简介 ####

Spring中的@Transactional注解，基于动态代理的机制，提供了一种透明的事务管理机制，方便快捷的解决在开发中碰到的问题，@Transactional 的事务开启 ，或者是基于接口的或者是基于类的代理被创建。Spring为了更好的支撑数据库操作，在框架中支持了两种事务管理的方式：编程式事务和声明式事务，能够保证作单个逻辑工作单元执行的一系列操作，要么同时成功，要么同时失败。

#### 如何使用 ####

（1）可以作用在类和方法上。  
（2）建议不要作用在接口或接口的方法上，因为只有使用基于接口的代理时注解才有效。建议作用在实现类的方法上。  
（3）当作用在类上时，该类的PUBLIC方法都具有该类型是事务属性，但是使用作用在方法上的注解来覆盖类级别的定义。  
（4）方法的访问权限为PUBLIC。  
（5）@Transactional(rollbackFor=Exception.class)，如果方法上加了这个注解，那么当这个方法抛出异常时（运行时和非运行时）就会回滚，数据库里面的数据也会回滚。如果不配置rollbackFor属性，那么事物只会在遇到运行时异常才会回滚。  
（6）默认情况下，SPRING只有在抛出的异常为运行时且为unchecked 异常才会回滚事务，也就是抛出的异常为RuntimeException 的子类(Errors也会)时才会回滚事务，而抛出 checked 异常则不会回滚事务 ，当然可以通过 @Transactional rollbackFor进行配置。

（6.1）checked异常： 一般是指程序不能直接控制的外界情况，是指在编译的时候就需要检查的一类异常，用户程序中必须采用try-catch机制处理或者通过throws交由调用者来处理。这类异常主要是指除了Error以及RuntimeException及其子类之外的异常。  
（6.2）unchecked异常：一般是那些不在编译的时就要处理的一类异常。在JAVA体系里，所有的Error以及RuntimeException及其子类都是unchecked异常。  
![在这里插入图片描述][1fe2ca353c814eaebf5768fe30b43df4.png]

###### 1. 源码定义 ######

@Target({
        ElementType.TYPE, ElementType.METHOD})
    @Retention(RetentionPolicy.RUNTIME)
    @Inherited
    @Documented
    public @interface Transactional {
        
    
    	// 可选的限定描述符，指定使用的事务管理器
    	@AliasFor("transactionManager")
    	String value() default "";
    
    	@AliasFor("value")
    	String transactionManager() default "";
    
    	String[] label() default {
        };
    
    	// 可选的事务传播机制
    	Propagation propagation() default Propagation.REQUIRED;
    
    	// 可选的事务隔离级别
    	Isolation isolation() default Isolation.DEFAULT;
    
    	// 事务超时时间设置
    	int timeout() default TransactionDefinition.TIMEOUT_DEFAULT;
    
    	String timeoutString() default "";
    
    	boolean readOnly() default false;
    
    	// 导致事务回滚的异常类
    	Class<? extends Throwable>[] rollbackFor() default {
        };
    
        // 导致事务回滚的异常类名称
    	String[] rollbackForClassName() default {
        };
    	
    	// 不会导致事务回滚的异常类
    	Class<? extends Throwable>[] noRollbackFor() default {
        };
    
        // 不会导致事务回滚的异常类名称
    	String[] noRollbackForClassName() default {
        };
    
    }

###### 2. 传播机制 ######

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th align="left">机制名称</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td align="left">REQUIRED</td> 
   <td align="left">默认值，如果当前存在事务，则加入该事务，如果当前没有事务，则创建一个新的事务。</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td align="left">REQUIRES_NEW</td> 
   <td align="left">首先创建一个新的事务，如果当前存在事务，则把当前事务挂起。</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td align="left">SUPPORTS</td> 
   <td align="left">如果当前存在事务，则加入该事务；如果当前没有事务，则以非事务的方式继续运行。</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td align="left">NOT_SUPPORTED</td> 
   <td align="left">以非事务方式运行，如果当前存在事务，则把当前事务挂起。</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td align="left">NEVER</td> 
   <td align="left">以非事务方式运行，如果当前存在事务，则抛出异常。</td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td align="left">MANDATORY</td> 
   <td align="left">如果当前存在事务，则加入该事务；如果当前没有事务，则抛出异常。</td> 
  </tr> 
  <tr> 
   <td>7</td> 
   <td align="left">NESTED</td> 
   <td align="left">如果当前存在事务，则创建一个事务作为当前事务的嵌套事务来运行； 如果当前没有事务，则该取值等价于TransactionDefinition.PROPAGATION_REQUIRED。</td> 
  </tr> 
 </tbody> 
</table>

###### 3. 隔离级别 ######

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th align="left">名称</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td align="left">DEFAULT</td> 
   <td align="left">使用后端数据库默认的隔离级别</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td align="left">READ_UNCOMMITTED</td> 
   <td align="left">读取未提交数据(会出现脏读， 不可重复读)</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td align="left">READ_COMMITTED</td> 
   <td align="left">读取已提交数据(会出现不可重复读和幻读)</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td align="left">REPEATABLE_READ</td> 
   <td align="left">可重复读(会出现幻读)</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td align="left">SERIALIZABLE</td> 
   <td align="left">串行化</td> 
  </tr> 
 </tbody> 
</table>

#### 使用场景 ####

##### 1. 同一个类 #####

###### 场景1 ######

同一类中有A和B两个方法，A方法上没有@Transactional注解，B方法上有，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作都不会回滚。

public void a() {
        
    	b();
    }
    @Transactional(rollbackFor = Exception.class)
    public void b() {
        
    }

###### 场景2 ######

同一类中有A和B两个方法，A方法上有@Transactional注解，B方法上没有，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
    public void a() {
        
    	b();
    }
    public void b() {
        
    }

###### 场景3 ######

同一类中有A和B两个方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
    public void a() {
        
    	b();
    }
    @Transactional(rollbackFor = Exception.class)
    public void b() {
        
    }

##### 2. 不同的类 #####

###### 场景1 ######

类1中有A方法，类2中有B方法，A方法上有@Transactional注解，B方法上没有，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
    public void a() {
        
    	b();
    }
    public void b() {
        
    }

###### 场景2 ######

类1中有A方法，类2中有B方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，此时A方法和B方法操作全部回滚。

@Transactional(rollbackFor = Exception.class)
    public void a() {
        
    	b();
    }
    @Transactional(rollbackFor = Exception.class)
    public void b() {
        
    }

###### 场景3 ######

类1中有A方法，类2中有B方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，但是A方法捕获了异常，此时B方法操作回滚，A方法抛出异常。

@Transactional(rollbackFor = Exception.class)
    public void a() {
        
    	try {
        
    	    b();
        } catch (Exception e) {
        
            e.printStackTrace();
        }
    }
    @Transactional(rollbackFor = Exception.class)
    public void b() {
        
    }

###### 场景4 ######

类1中有A方法，类2中有B方法，A方法和B方法上都有@Transactional注解，上层应用通过A方法间接调用B方法，B方法抛出异常，但是A方法捕获了异常，此时B方法操作回滚，A方法操作成功。

@Transactional(rollbackFor = Exception.class)
    public void a() {
        
    	try {
        
    	    b();
        } catch (Exception e) {
        
            e.printStackTrace();
        }
    }
    @Transactional(propagation = Propagation.REQUIRES_NEW, rollbackFor = Exception.class)
    public void b() {
        
    }

[1fe2ca353c814eaebf5768fe30b43df4.png]: https://img-blog.csdnimg.cn/1fe2ca353c814eaebf5768fe30b43df4.png