前言
WebFlux 是 Spring Framework 5.0 中引入的一种新型反应式编程模型,支持非阻塞 I/O,适用于高并发、高吞吐量的应用程序。在 WebFlux 应用程序中使用事务需要注意以下几点。使用 Reactive R2DBC:WebFlux 支持使用 Reactive R2DBC 访问关系型数据库。R2DBC 是一个反应式的数据库连接规范,它允许开发人员以响应式方式访问关系型数据库。在 WebFlux 应用程序中使用 Reactive R2DBC 可以实现非阻塞式的数据库操作。使用 @Transactional 注解:在 WebFlux 应用程序中,可以使用 @Transactional 注解声明事务边界,将多个数据库操作绑定到同一事务中。需要注意的是,@Transactional 注解需要与 Reactive R2DBC 结合使用,确保事务管理器与 R2DBC 兼容。遵循响应式编程原则:在 WebFlux 应用程序中,需要遵循响应式编程的原则,使用 Mono 和 Flux 等响应式类型来处理数据流,而不是传统的阻塞式方法。这意味着在事务中涉及到的所有操作,都需要返回 Mono 或 Flux 对象,并且保证响应式链条的正确性。
本节内容以关系型数据库mysql为例,通过使用spring-boot-starter-data-r2dbc框架完成关系型数据库的调用,并通过具体的案例实现webflux应用下的数据库事务管理,包含最佳的使用实战案例,通过spring的AOP实现最终的事务控制。
正文
①引入必要的pom组件,其中spring-boot-starter-aop可以不引入,如果不使用aop管理r2dbc的数据库事务
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-aop</artifactId>
</dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId>
</dependency><!-- https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-starter-webflux-ui -->
<dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webflux-ui</artifactId><version>2.3.0</version>
</dependency><!-- 响应式 Spring Data R2dbc-->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-r2dbc</artifactId>
</dependency><!-- https://mvnrepository.com/artifact/io.asyncer/r2dbc-mysql -->
<dependency><groupId>io.asyncer</groupId><artifactId>r2dbc-mysql</artifactId><version>1.0.6</version>
</dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-webflux</artifactId>
</dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope>
</dependency>
<dependency><groupId>io.projectreactor</groupId><artifactId>reactor-test</artifactId><scope>test</scope>
</dependency>
②创建控制层UserController请求接口测试方法:新增用户
@Operation(summary = "新增用户", description = "新增用户")
@PostMapping(value = "saveUser")
public Mono<ApiResponse> saveUser(@RequestBody User user) {Mono<User> userMono = userService.saveUser(user);return userMono.map(ApiResponse::success);
}
③创建UserService的业务接口层
/*** 新增用户** @param user* @return*/
Mono<User> saveUser(User user);
④创建UserServiceImpl的业务实现层
@Overridepublic Mono<User> saveUser(User user) {return userRepository.save(user);}
⑤创建UserRepository数据操作层
package com.yundi.atp.repository;import com.yundi.atp.entity.User;
import org.springframework.data.r2dbc.repository.Query;
import org.springframework.data.r2dbc.repository.R2dbcRepository;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;
import reactor.core.publisher.Mono;@Repository
public interface UserRepository extends R2dbcRepository<User, Integer> {/*** 根据用户名获取用户信息** @param name* @return*/Mono<User> findUsersByName(@Param("name") String name);/*** 更新用户信息** @param user* @return*/@Query("update user set name = :#{#user.name}, age = :#{#user.age} where id = :#{#user.id}")Mono<User> updateUser(@Param("user") User user);/*** 动态更新用户信息** @param user* @return*/@Query("UPDATE User SET " +"name = CASE WHEN :#{#user.name} IS NULL THEN name ELSE :#{#user.name} END, " +"age = CASE WHEN :#{#user.age} IS NULL THEN age ELSE :#{#user.age} END " +"WHERE id = :#{#user.id}")Mono<User> updateUserQuery(@Param("user") User user);
}
⑥ 正常通过swagger工具访问用户新增接口,数据可以正常插入数据库
⑦在保存用户的业务方法中人为创建一个异常,验证是否能够正常保存数据
@Override
public Mono<User> saveUser(User user) {Mono<User> monoUser = userRepository.save(user);//人为创建一个数学异常System.out.println(1/0);return monoUser;
}
⑧使用swagger工具访问用户新增接口,从打印的日志来看,数据并没有插入成功,并抛出了异常,但是这里并没有数据库的事务处理
PS:这里可能会误导初学者,认为webflux的r2dbc具备天然的事务处理机制,其实不然,这是因为webflux是响应式非阻塞式编程,所有操作都是异步执行,导致业务方法会跳过用户保存的操作而先去执行异常的部分代码,直接消费异常处理结果,真正的用户保存方法并没有执行。
⑨使用@Transactional,加入事务处理注解,查看是否会有事务执行
@Transactional(rollbackFor = Exception.class)
@Override
public Mono<User> saveUser(User user) {Mono<User> mono = userRepository.save(user);System.out.println(1/0);return mono;
}
⑩使用swagger工具访问用户新增接口,从打印的日志来看,加入@Transactional确实切入了事务,但是由于异步执行,跳过了用户保存的方法,用户保存sql并未执行,这里的事务看起来并没有起什么作用
⑪使用Mono的flatMap方法将业务方法改为如下方式,先执行用户保存方法,在触发异常,查看打印结果
@Transactional(rollbackFor = Exception.class)
@Override
public Mono<User> saveUser(User user) {return userRepository.save(user).flatMap(item -> {System.out.println("item:" + item);System.out.println(1 / 0);return Mono.just(item);});
}
⑫使用swagger工具访问用户新增接口,从打印的日志来看,数据持久化sql操作真实执行了,但并没有真实插入数据库,事务确定已经真实生效,数据进行了回滚
⑬利用事务的传播机制,测试内层事务出现异常,内外层事务都会回滚
@Transactional(rollbackFor = Exception.class)
@Override
public Mono<User> saveUser(User user) {return userRepository.save(user).flatMap(item -> {System.out.println("item:" + item);return userRepository.findUsersByName(item.getName()).flatMap(it -> {System.out.println("it:" + it);System.out.println(1 / 0);return Mono.just(it);});});
}
⑭使用swagger工具访问用户新增接口,从打印的日志来看,内外层的sql都执行了,由于内层异常,导致全局的异常回滚,说明异常的传播机制是shengx
⑮最佳实践:使用aop切面实现数据库事务的统一管理,创建全局事务处理配置类ReactiveTransactionConfig
package com.yundi.atp.config;import io.r2dbc.spi.ConnectionFactory;
import jakarta.annotation.Resource;
import org.springframework.aop.Advisor;
import org.springframework.aop.aspectj.AspectJExpressionPointcut;
import org.springframework.aop.support.DefaultPointcutAdvisor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.r2dbc.connection.R2dbcTransactionManager;
import org.springframework.transaction.ReactiveTransactionManager;
import org.springframework.transaction.TransactionDefinition;
import org.springframework.transaction.annotation.EnableTransactionManagement;
import org.springframework.transaction.interceptor.DefaultTransactionAttribute;
import org.springframework.transaction.interceptor.NameMatchTransactionAttributeSource;
import org.springframework.transaction.interceptor.TransactionInterceptor;@Configuration
@EnableTransactionManagement
public class ReactiveTransactionConfig {@Resourceprivate ConnectionFactory connectionFactory;@Beanpublic ReactiveTransactionManager reactiveTransactionManager() {return new R2dbcTransactionManager(connectionFactory);}@Bean(name = "myTransactionInterceptor")public TransactionInterceptor myTransactionInterceptor() {//写事务控制DefaultTransactionAttribute txAttr_REQUIRED = new DefaultTransactionAttribute();txAttr_REQUIRED.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);txAttr_REQUIRED.setTimeout(2000);//读事务控制DefaultTransactionAttribute txAttr_REQUIRED_READONLY = new DefaultTransactionAttribute();txAttr_REQUIRED_READONLY.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);NameMatchTransactionAttributeSource source = new NameMatchTransactionAttributeSource();source.addTransactionalMethod("page*", txAttr_REQUIRED_READONLY);source.addTransactionalMethod("find*", txAttr_REQUIRED_READONLY);source.addTransactionalMethod("query*", txAttr_REQUIRED_READONLY);source.addTransactionalMethod("list*", txAttr_REQUIRED_READONLY);source.addTransactionalMethod("get*", txAttr_REQUIRED_READONLY);source.addTransactionalMethod("save*", txAttr_REQUIRED);source.addTransactionalMethod("add*", txAttr_REQUIRED);source.addTransactionalMethod("update*", txAttr_REQUIRED);source.addTransactionalMethod("remove*", txAttr_REQUIRED);source.addTransactionalMethod("delete*", txAttr_REQUIRED);return new TransactionInterceptor(reactiveTransactionManager(), source);}/*** 切点** @return*/@Beanpublic Advisor advisor() {AspectJExpressionPointcut pointcut = new AspectJExpressionPointcut();pointcut.setExpression("execution(* com.yundi.atp.service..*(..))");return new DefaultPointcutAdvisor(pointcut, myTransactionInterceptor());}}
⑯使用swagger工具访问用户新增接口,从打印的日志来看,不加@Transactional,依然可以实现事务处理
结语
至此,关于webflux项目数据库事务的内容到这里就结束了,我们下期见。。。。。。