介绍
@Transactional注解是Spring框架用于简化声明式事务管理的关键元素。它允许开发者通过简单的注解来控制事务的边界,而无需编写具体的事务管理代码。
用途:用于指定一个方法或类在执行时需要进行事务管理。
位置:
- 类级别:应用于类上时,表示该类中的所有公共方法(public methods)都将自动加入事务管理。类级别的设置可以被方法级别的设置覆盖。
- 方法级别:更精确地控制事务边界,仅应用于特定方法。方法级别上的设置优先于类级别设置。
重要参数
尽管@Transactional可以不带任何参数直接使用,默认情况下它具有一定的行为,但也可以通过参数来调整其行为,包括但不限于:
- value 或transactionManager:指定使用的事务管理器的名称。如果不指定,默认使用配置的事务管理器。
- propagation:事务传播行为,默认为`REQUIRED`,表示如果当前存在事务,则加入当前事务;如果不存在,则新建一个事务。
- isolation:事务的隔离级别,默认由数据库决定。
- readOnly:指示事务是否只读,默认为`false`,表明事务可读写。设为`true`可以优化性能,因为某些数据库在只读事务中可以采取优化措施。
- timeout:事务超时时间,默认无限制。单位是秒。
- rollbackFor:指定需要进行回滚的异常类型数组。当方法抛出的异常匹配指定的异常类型时,事务将回滚。
- noRollbackFor:指定不需要进行回滚的异常类型数组。即使方法抛出这些异常,事务也不会回滚。
行为特点
- 作用域:`@Transactional`注解只能应用在**public**方法上。应用在protected、private或其他访问修饰符的方法上时,注解将被忽略。
- 异常处理:默认情况下,只有未被捕获的`RuntimeException`及其子类和`Error`才会导致事务回滚。对于已检查异常(checked exceptions),需通过`rollbackFor`属性显式指定才触发回滚。
- 代理和AOP:事务管理是通过Spring的AOP(面向切面编程)实现的,因此只有通过Spring代理的对象调用事务方法时,事务才生效。这意味着在同一个类内的方法调用不会触发事务行为。
使用建议
- 服务层应用:通常建议在业务服务层(如Service层)使用`@Transactional`注解,而不是在数据访问对象(DAO)或控制器层,因为事务管理更多关联于业务逻辑而非数据访问细节。
- 谨慎使用:虽然`@Transactional`简化了事务管理,但过度或不当使用可能导致难以预料的行为,比如事务过于宽泛或过于细碎,都可能影响性能或数据一致性。
实际应用
在实际应用中,在ServiceImpl层中的public方法上,添加 @Transactional(rollbackFor = Exception.class),若代码抛出任何类型的异常(Exception)(通过rollbackFor = Exception.class
指定),那么事务将会被回滚,这意味着在该方法中执行的所有数据库操作都将被撤销,确保数据的完整性。
@Transactional(rollbackFor = Exception.class)
@Override
public String importFile(MultipartFile file, String nickName) {
//采用easyExcel导入并解析模版中的数据
List<PriceValve> valves = FileUtil.importExcel(file, 0, 1, PriceValve.class);
if (CollectionUtils.isEmpty(valves)) {
return "参数为空,导入失败";
}
for (PriceValve valve : valves) {
valve.setCreateBy(nickName);
//对数据查重后再新增
String result = insertValve(valve);
if (!StringUtils.isEmpty(result)) {
//抛出异常,事务管理器捕捉并回滚数据
throw new RuntimeException(result);
}
}
return null;
}
@Override
public String insertValve(PriceValve priceValve) {
//根据型号和等级查找详情,判断是否有重复(实体类已对字段判空)
Integer count = priceValveMapper.distinctValve(priceValve);
if (count != 0) {
return "型号:" + priceValve.getName() + ",尺寸:" + priceValve.getDn() + ",类型:" + priceValve.getType()
+ ",等级:" + priceValve.getPn() + "数据已存在,请检查数据后重新存储";
}
priceValve.setCreateTime(new Date());
priceValveMapper.insert(priceValve);
return null;
}