@Transactional注解超详细

简介: @Transactional注解超详细

本文前言

@Transactional注解是Spring框架中用于声明式事务管理的关键注解。本文将深入探讨@Transactional注解的作用、使用方式和常见属性,并结合代码实例演示其在实际项目中的应用,以帮助读者更好地理解和使用该注解。

概念说明

 @Transactional注解是Spring框架提供的一个用于声明式事务管理的注解。它可以应用在方法或类上,用于标识需要进行事务管理的方法或类。通过使用@Transactional注解,我们可以更加方便地管理事务,保障数据的一致性和可靠性。在介绍@Transactional注解之前,我们先来了解一下事务的基本概念。事务具有四个基本特性:「原子性 」、「一致性 」、「隔离性 」和「持久性 」。

  • 「原子性 」表示一个事务中的所有操作要么全部成功执行,要么全部失败回滚;
  • 「一致性 」表示事务执行前后数据库的状态保持一致;
  • 「隔离性 」表示多个事务并发执行时,彼此之间是相互隔离的,互不干扰;
  • 「持久性 」表示一旦事务提交,其所做的修改将永久保存在数据库中。

使用说明

 使用@Transactional注解的方式 @Transactional注解可以应用在方法或类上。

1.当应用在方法上时,该方法将被纳入事务管理;

ae5b9b0563cc48e19109a2bfe7b045bf.png

2ad53b54a81640a88842f23550ebc9fa.png

2.当应用在类上时,该类中的所有方法都将被纳入事务管理。

8d418081d4dc4079a6aa16ba7c7496d0.png

9bc07a97996b4dd8994ef94857ac4d79.png

3.常用属性 @Transactional注解有许多属性可供配置,其中一些常用的属性包括事务传播行为、隔离级别和超时设置。事务传播行为用于定义事务方法与其他事务方法的关系;隔离级别用于定义事务方法之间的隔离程度;超时设置用于定义事务方法的最大执行时间。我们可以根据应用程序的需求来灵活配置这些属性。

59875971f5494c04965b8fba727608f5.png

底层实现

public class TransactionalAnnotationProcessor {
    private PlatformTransactionManager transactionManager;
    public TransactionalAnnotationProcessor(PlatformTransactionManager transactionManager) {
        this.transactionManager = transactionManager;
    }
    public Object process(Object target, Method method, Object[] args) throws Throwable {
        Transactional transactional = method.getAnnotation(Transactional.class);
        TransactionStatus transactionStatus = null;
        try {
            // 开启事务
            transactionStatus = transactionManager.getTransaction(new DefaultTransactionDefinition());
            // 执行目标方法
            Object result = method.invoke(target, args);
            // 提交事务
            transactionManager.commit(transactionStatus);
            return result;
        } catch (Exception ex) {
            // 回滚事务
            if (transactionStatus != null) {
                transactionManager.rollback(transactionStatus);
            }
            throw ex;
        }
    }
}

 TransactionalAnnotationProcessor类是一个简化版本的注解解析器。它接收一个PlatformTransactionManager对象作为构造函数的参数,用于管理事务。process()方法接收目标对象、目标方法和方法参数作为参数。该方法首先通过反射获取目标方法上的@Transactional注解,然后根据注解的配置开启事务。接着,执行目标方法,并根据方法执行的结果决定是提交事务还是回滚事务。

注意事项

1.Transactional注解标注方法修饰符为非public

Transactional注解标注方法修饰符为非public
   @Transactional(rollbackFor = Exception.class)
    private void executeInsertSQL(String tableName,String columnName,String placeholderOfColumnName,List<String> fieldNameList,List<Object> valuesOfField ) throws SQLException {
        TransactionStatus transactionStatus=null;
        PlatformTransactionManager transactionManager=null;
        try{
            String sql = "insert into "+tableName+"  (" + columnName + ") values(" + placeholderOfColumnName + ")";
            //获取EntityManager对象
            EntityManager entityManager = Actor.applicationContext.getBean(EntityManager.class);
            transactionManager = Actor.applicationContext.getBean(PlatformTransactionManager.class);
            //手动开启事务
            transactionStatus= transactionManager.getTransaction(new DefaultTransactionDefinition());
            // 使用EntityManager执行JPA操作
            Query nativeQuery = entityManager.createNativeQuery(sql);
            for (int i=0;i<valuesOfField.size();i++){
                nativeQuery.setParameter(fieldNameList.get(i), valuesOfField.get(i));
            }
            nativeQuery.executeUpdate();
            //手动提交事务
            transactionManager.commit(transactionStatus);
        }catch (Exception e){
            if(transactionStatus!=null ){
                //回滚事务
                transactionManager.rollback(transactionStatus);
            }
            e.printStackTrace();
        }
    }

540de0f0372445959e766c8072da56ab.png

Transactional注解标注方法修饰符为非public时,@Transactional注解将会不起作用。因此在方法抛出异常时,nativeQuery.executeUpdate();操作不会进行回滚。如果executeInsertSQL方法改为public的话将会正常开启事务,然后在决定是提交事务还是回滚。

2.在类内部非@Transactional标注的方法,调用类内部@Transactional标注的方法

public void text() throws SQLException {
        List<Object> objects = new ArrayList<>();
        List<String> stringList = new ArrayList<>();
        this.executeInsertSQL("12","21","wzl",stringList,objects);
    }
    /*
     * @description:执行插入的sql语句
     * @author: wuzilong
     * @date: 2023/6/12 17:10
     * @param: [tableName, fieldStr, valueStr, fieldNameList, values]
     * @return: void
     **/
    @Transactional(rollbackFor = Exception.class)
    public void executeInsertSQL(String tableName,String columnName,String placeholderOfColumnName,List<String> fieldNameList,List<Object> valuesOfField ) throws SQLException {
        TransactionStatus transactionStatus=null;
        PlatformTransactionManager transactionManager=null;
        try{
            String sql = "insert into "+tableName+"  (" + columnName + ") values(" + placeholderOfColumnName + ")";
            //获取EntityManager对象
            EntityManager entityManager = Actor.applicationContext.getBean(EntityManager.class);
            transactionManager = Actor.applicationContext.getBean(PlatformTransactionManager.class);
            //手动开启事务
            transactionStatus= transactionManager.getTransaction(new DefaultTransactionDefinition());
            // 使用EntityManager执行JPA操作
            Query nativeQuery = entityManager.createNativeQuery(sql);
            for (int i=0;i<valuesOfField.size();i++){
                nativeQuery.setParameter(fieldNameList.get(i), valuesOfField.get(i));
            }
            nativeQuery.executeUpdate();
            //手动提交事务
            transactionManager.commit(transactionStatus);
        }catch (Exception e){
            if(transactionStatus!=null ){
                //回滚事务
                transactionManager.rollback(transactionStatus);
            }
            e.printStackTrace();
        }
    }

6f6d7040adef4a529d24a1acbffa3d7a.png

调用一个方法在类内部调用内部被@Transactional标注的事务方法,运行结果是事务不会正常开启,nativeQuery.executeUpdate();操作将会保存到数据库不会进行回滚。

3.事务方法内部捕捉了异常,没有抛出新的异常

@Transactional(rollbackFor = Exception.class)
    public void executeInsertSQL(String tableName,String columnName,String placeholderOfColumnName,List<String> fieldNameList,List<Object> valuesOfField ) throws SQLException {
        TransactionStatus transactionStatus=null;
        PlatformTransactionManager transactionManager=null;
        try{
            String sql = "insert into "+tableName+"  (" + columnName + ") values(" + placeholderOfColumnName + ")";
            //获取EntityManager对象
            EntityManager entityManager = Actor.applicationContext.getBean(EntityManager.class);
            transactionManager = Actor.applicationContext.getBean(PlatformTransactionManager.class);
            //手动开启事务
            transactionStatus= transactionManager.getTransaction(new DefaultTransactionDefinition());
            // 使用EntityManager执行JPA操作
            Query nativeQuery = entityManager.createNativeQuery(sql);
            for (int i=0;i<valuesOfField.size();i++){
                nativeQuery.setParameter(fieldNameList.get(i), valuesOfField.get(i));
            }
            nativeQuery.executeUpdate();
            //手动提交事务
            transactionManager.commit(transactionStatus);
        }catch (Exception e){
            System.out.println("抛出了一个异常");
        }
    }

32e1d5d14d7d4d1db1b2b576c35aba8d.png

 运行程序发现,虽然抛出异常,但是异常被捕捉了,没有抛出到方法外, nativeQuery.executeUpdate();操作并没有回滚。

注解扩展

76949b4057c24347a953700b376be3be.png

 以上是一些常用的与@Transactional注解相似的注解,它们都可以用来简化开发、提高代码的可读性和可维护性。您可以根据实际需求选择合适的注解来使用。

总结提升

 @Transactional注解是Spring框架中用于声明式事务管理的关键注解。通过使用@Transactional注解,我们可以更加方便地管理事务,保障数据的一致性和可靠性。在实际项目中,合理使用@Transactional注解可以提高「开发效率 」和代码「可维护性 」。希望本文能帮助读者更好地理解和使用@Transactional注解。

🎯 此文章对你有用的话记得留言+点赞+收藏哦🎯

相关文章
|
Java 数据库
POJO、PO、DTO、DAO、BO、VO需要搞清楚的概念
POJO 全称为:Plain Ordinary Java Object,即简单普通的java对象。一般用在数据层映射到数据库表的类,类的属性与表字段一一对应。 PO 全称为:Persistant Object,即持久化对象。
33267 1
|
3月前
|
关系型数据库 MySQL Java
MySQL 分库分表 + 平滑扩容方案 (秒懂+史上最全)
MySQL 分库分表 + 平滑扩容方案 (秒懂+史上最全)
|
6月前
|
Java 关系型数据库 MySQL
深入解析 @Transactional——Spring 事务管理的核心
本文深入解析了 Spring Boot 中 `@Transactional` 的工作机制、常见陷阱及最佳实践。作为事务管理的核心注解,`@Transactional` 确保数据库操作的原子性,避免数据不一致问题。文章通过示例讲解了其基本用法、默认回滚规则(仅未捕获的运行时异常触发回滚)、因 `try-catch` 或方法访问修饰符不当导致失效的情况,以及数据库引擎对事务的支持要求。最后总结了使用 `@Transactional` 的五大最佳实践,帮助开发者规避常见问题,提升项目稳定性与可靠性。
840 12
|
缓存 监控 安全
Spring AOP 详细深入讲解+代码示例
Spring AOP(Aspect-Oriented Programming)是Spring框架提供的一种面向切面编程的技术。它通过将横切关注点(例如日志记录、事务管理、安全性检查等)从主业务逻辑代码中分离出来,以模块化的方式实现对这些关注点的管理和重用。 在Spring AOP中,切面(Aspect)是一个模块化的关注点,它可以跨越多个对象,例如日志记录、事务管理等。切面通过定义切点(Pointcut)和增强(Advice)来介入目标对象的方法执行过程。 切点是一个表达式,用于匹配目标对象的一组方法,在这些方法执行时切面会被触发。增强则定义了切面在目标对象方法执行前、执行后或抛出异常时所
16422 4
|
Java 编译器 Spring
面试突击78:@Autowired 和 @Resource 有什么区别?
面试突击78:@Autowired 和 @Resource 有什么区别?
15074 5
|
SQL Java 数据库
Transactional注解讲解及使用
事务是数据库操作的一组集合,它作为一个工作单元,要求所有操作要么全部成功,要么全部失败。事务的四个基本特性是原子性(Atomicity)、一致性(Consistency)、隔离性(Isolation)和持久性(Durability)。
|
消息中间件 Java 关系型数据库
Spring事务畅谈 —— 由浅入深彻底弄懂 @Transactional注解(1)
Spring事务畅谈 —— 由浅入深彻底弄懂 @Transactional注解
5565 0
|
JSON 负载均衡 Java
SpringCloud Feign 远程调用(史上最详细讲解)
SpringCloud Feign 远程调用(史上最详细讲解)
13952 0
SpringCloud Feign 远程调用(史上最详细讲解)
|
Java 数据库连接 Spring