transactional详解参数,transaction it

事务性介绍1。事务性可以应用于接口、类和类方法。当编程式事务发布一个类的事务注释时，意味着这个类的所有公共方法都配置了相同的事务属性信息。声明式事务,配置类时，也配置了事务性方法。

了Transactional方法的事务会覆盖类的事务配置信息。

作用于接口不推荐这种使用方法因为一旦标注在Interface上并且配置了Spring AOP 使用CGLib动态代理将会导致Transactional注解失效。

 Transactional RestController RequestMapping public class MyController {     Autowired     private StudentMapper studentMapper;      Transactional(rollbackFor  Exception.class)     GetMapping(/test)     public void test() throws Exception {       Student student  new Student();        student.setName(chamption-Dai)        int insert  studentMapper.insert(cityInfoDict);   }}

2、Transactional注有哪些属性 属性类型描述valueString可选的限定描述符指定使用的事务管理器propagationenum: Propagation可选的事务传播行为设置isolationenum: Isolation可选的事务隔离级别设置readOnlyboolean读写或只读事务默认读写timeoutint (in seconds granularity)事务超时时间设置rollbackForClass对象数组必须继承自Throwable导致事务回滚的异常类数组rollbackForClassName类名数组必须继承自Throwable导致事务回滚的异常类名字数组noRollbackForClass对象数组必须继承自Throwable不会导致事务回滚的异常类数组noRollbackForClassName类名数组必须继承自Throwable不会导致事务回滚的异常类名字数组 propagation属性

propagation 代表事务的传播行为默认值为 Propagation.REQUIRED其他的属性信息如下

属性说明Propagation.REQUIRED如果当前存在事务则加入该事务如果当前不存在事务则创建一个新的事务。( 也就是说如果A方法和B方法都添加了注解在默认传播模式下A方法内部调用B方法会把两个方法的事务合并为一个事务 Propagation.SUPPORTS如果当前存在事务则加入该事务如果当前不存在事务则以非事务的方式继续运行。Propagation.MANDATORY如果当前存在事务则加入该事务如果当前不存在事务则抛出异常。Propagation.REQUIRES_NEW重新创建一个新的事务如果当前存在事务暂停当前的事务。( 当类A中的 a 方法用默认Propagation.REQUIRED模式类B中的 b方法加上用 Propagation.REQUIRES_NEW模式然后在 a 方法中调用 b方法操作数据库然而 a方法抛出异常后b方法并没有进行回滚因为Propagation.REQUIRES_NEW会暂停 a方法的事务 )Propagation.NOT_SUPPORTED以非事务的方式运行如果当前存在事务暂停当前的事务。Propagation.NEVER以非事务的方式运行如果当前存在事务则抛出异常。Propagation.NESTED和 Propagation.REQUIRED 效果一样。 isolation 属性

isolation 事务的隔离级别默认值为 Isolation.DEFAULT。

Isolation.DEFAULT使用底层数据库默认的隔离级别。

Isolation.READ_UNCOMMITTED

Isolation.READ_COMMITTED

Isolation.REPEATABLE_READ

Isolation.SERIALIZABLE

timeout 属性

timeout 事务的超时时间默认值为 -1。如果超过该时间限制但事务还没有完成则自动回滚事务。

示例

Servicepublic class UserServiceImpl implements UserService{// 加载mapperAutowiredprivate UserMapper usermapper;Transactional(propagationPropagation.REQUIRED,timeout5) // 启用事务管理public void myTransaction(User addUser, User updateuser) {    System.out.println(---- 方法开始 );    usermapper.add(addUser);    try {        Thread.sleep(6000);    } catch (InterruptedException e) {        // TODO Auto-generated catch block        e.printStackTrace();    }    usermapper.update(updateuser);    System.out.println(----方法结束 );}}

运行结果

最终由于事务超时事务回滚。
运行的时候由于事务超时就会报错 TransactionTimedOutException:…

readOnly 属性

readOnly 指定事务是否为只读事务默认值为 false为了忽略那些不需要事务的方法比如读取数据可以设置 read-only 为 true。

rollbackFor 属性

rollbackFor 用于指定能够触发事务回滚的异常类型可以指定多个异常类型。

noRollbackFor属性

noRollbackFor抛出指定的异常类型不回滚事务也可以指定多个异常类型。

三、Transactional失效场景

接下来我们结合具体的代码分析一下哪些场景下Transactional 注解会失效。

1.Transactional 应用在非 public 修饰的方法上

如果Transactional注解应用在非public 修饰的方法上Transactional将会失效。

图片来自“程序员那点事”

之所以会失效是因为在Spring AOP 代理时如上图所示 TransactionInterceptor 事务拦截器在目标方法执行前后进行拦截DynamicAdvisedInterceptorCglibAopProxy 的内部类的 intercept 方法或 JdkDynamicAopProxy 的 invoke 方法会间接调用 AbstractFallbackTransactionAttributeSource的 computeTransactionAttribute 方法获取Transactional 注解的事务配置信息。

protected TransactionAttribute computeTransactionAttribute(Method method,    Class<?> targetClass) {        // Dont allow no-public methods as required.        if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {        return null;}

此方法会检查目标方法的修饰符是否为 public不是 public则不会获取Transactional 的属性配置信息。

注意protected、private 修饰的方法上使用 Transactional 注解虽然事务无效但不会有任何报错这是我们很容犯错的一点。

2、Transactional 注解属性 propagation 设置错误

这种失效是由于配置错误若是错误的配置以下三种 propagation事务将不会发生回滚。

TransactionDefinition.PROPAGATION_SUPPORTS如果当前存在事务则加入该事务如果当前没有事务则以非事务的方式继续运行。TransactionDefinition.PROPAGATION_NOT_SUPPORTED以非事务方式运行如果当前存在事务则把当前事务挂起。TransactionDefinition.PROPAGATION_NEVER以非事务方式运行如果当前存在事务则抛出异常。 3、Transactional 注解属性 rollbackFor 设置错误

rollbackFor 可以指定能够触发事务回滚的异常类型。Spring默认抛出了未检查unchecked异常继承自 RuntimeException的异常或者 Error才回滚事务其他异常不会触发回滚事务。如果在事务中抛出其他类型的异常但却期望 Spring 能够回滚事务就需要指定 rollbackFor属性。

// 希望自定义的异常可以进行回滚
Transactional(propagation Propagation.REQUIRED,rollbackFor MyException.class
若在目标方法中抛出的异常是 rollbackFor 指定的异常的子类事务同样会回滚。Spring源码如下

private int getDepth(Class<?> exceptionClass, int depth) {       if (exceptionClass.getName().contains(this.exceptionName)) {           // Found it!            return depth;       }       // If weve gone as far as we can go and havent found it...       if (exceptionClass  Throwable.class) {            return -1;       }       return getDepth(exceptionClass.getSuperclass(), depth  1);}

4、同一个类中方法调用导致Transactional失效、

开发中避免不了会对同一个类里面的方法调用比如有一个类Test它的一个方法AA再调用本类的方法B不论方法B是用public还是private修饰但方法A没有声明注解事务而B方法有。则外部调用方法A之后方法B的事务是不会起作用的。这也是经常犯错误的一个地方。

那为啥会出现这种情况其实这还是由于使用Spring AOP代理造成的因为只有当事务方法被当前类以外的代码调用时才会由Spring生成的代理对象来管理。

//Transactional  去掉事务     GetMapping(/test)     private Integer A() throws Exception {         CityInfoDict cityInfoDict  new CityInfoDict();         cityInfoDict.setCityName(2);         /**          * B 插入字段为 3的数据          */         this.insertB();        /**         * A 插入字段为 2的数据         */        int insert  cityInfoDictMapper.insert(cityInfoDict);       return insert;    }    Transactional()    public Integer insertB() throws Exception {        CityInfoDict cityInfoDict  new CityInfoDict();        cityInfoDict.setCityName(3);        cityInfoDict.setParentCityId(3);        return cityInfoDictMapper.insert(cityInfoDict);    }

5、异常被你的 catch“吃了”导致Transactional失效

这种情况是最常见的一种Transactional注解失效场景

 1    Transactional 2    private Integer A() throws Exception { 3        int insert  0; 4        try { 5            CityInfoDict cityInfoDict  new CityInfoDict(); 6            cityInfoDict.setCityName(Champtional-Dai); 7            cityInfoDict.setParentCityId(1111); 8            /** 9             * A 插入字段为 2的数据10             */11            insert  cityInfoDictMapper.insert(cityInfoDict);12            /**13             * B 插入字段为 3的数据14             */15            b.insertB();16        } catch (Exception e) {17            e.printStackTrace();18        }19    }

问如果B方法内部抛了异常而A方法此时try catch了B方法的异常那这个事务还能正常回滚吗

答案不能

会抛出异常

org.springframework.transaction.UnexpectedRollbackException:Transaction rolled back because it has been marked as rollback-only

因为当ServiceB中抛出了一个异常以后ServiceB标识当前事务需要rollback。但是ServiceA中由于你手动的捕获这个异常并进行处理ServiceA认为当前事务应该正常commit。此时就出现了前后不一致也就是因为这样抛出了前面的UnexpectedRollbackException异常。

spring的事务是在调用业务方法之前开始的业务方法执行完毕之后才执行commit or rollback事务是否执行取决于是否抛出runtime异常。如果抛出runtime exception 并在你的业务方法中没有catch到的话事务会回滚。

在业务方法中一般不需要catch异常如果非要catch一定要手动抛出throw new RuntimeException()否则会导致事务失效数据commit造成数据不一致所以有些时候try catch反倒会画蛇添足。

6、数据库引擎不支持事务

这种情况出现的概率并不高事务能否生效数据库引擎是否支持事务是关键。常用的MySQL数据库默认使用支持事务的innodb引擎。一旦数据库引擎切换成不支持事务的myisam那事务就从根本上失效了。