导航：首页 > 数据库 >

如何理解反应式数据库驱动规范R2DBC

发表于：2025-11-07 作者：千家信息网编辑

千家信息网最后更新 2025年11月07日，本篇文章为大家展示了如何理解反应式数据库驱动规范R2DBC，内容简明扼要并且容易理解，绝对能使你眼前一亮，通过这篇文章的详细介绍希望你能有所收获。1. 简介R2DBC是一种异步的、非阻塞的关系式数据库

千家信息网最后更新 2025年11月07日如何理解反应式数据库驱动规范R2DBC

本篇文章为大家展示了如何理解反应式数据库驱动规范R2DBC，内容简明扼要并且容易理解，绝对能使你眼前一亮，通过这篇文章的详细介绍希望你能有所收获。

1. 简介

R2DBC是一种异步的、非阻塞的关系式数据库连接规范。尽管一些NoSQL数据库供应商为其数据库提供了反应式数据库客户端，但对于大多数项目而言，迁移到NoSQL并不是一个理想的选择。这促使了一个通用的响应式关系数据库连接规范的诞生。作为拥有庞大用户群的关系式数据库MySQL也有了反应式驱动，不过并不是官方的。但是Spring官方将其纳入了依赖池，说明该类库的质量并不低。所以今天就尝尝鲜，试一下使用R2DBC连接MySQL。

2. 环境依赖

基于Spring Boot 2.3.1和Spring Data R2DBC，还有反应式Web框架Webflux，同时也要依赖r2dbc-mysql库，所有的Maven依赖为：

                           dev.miku            r2dbc-mysql                                    org.springframework.boot            spring-boot-starter-data-r2dbc                                    org.springframework.boot            spring-boot-starter-data-jdbc                                   org.springframework.boot            spring-boot-starter-webflux

MySQL版本为5.7，没有测试其它版本。

3. R2DBC配置

所有的R2DBC自动配置都在org.springframework.boot.autoconfigure.data.r2dbc包下，如果要配置MySQL必须针对性的配置对应的连接工厂接口ConnectionFactory，当然也可以通过application.yml配置。个人比较喜欢JavaConfig。

@BeanConnectionFactory connectionFactory() {    return MySqlConnectionFactory.from(MySqlConnectionConfiguration.builder()            .host("127.0.0.1")            .port(3306)            .username("root")            .password("123456")            .database("database_name")             // 额外的其它非必选参数省略                                      .build());}

详细配置可参考r2dbc-mysql的官方说明：https://github.com/mirromutth/r2dbc-mysql

当ConnectionFactory配置好后，就会被注入DatabaseClient 对象。该对象是非阻塞的，用于执行数据库反应性客户端调用与反应流背压请求。我们可以通过该接口反应式地操作数据库。

4. 编写反应式接口

我们先创建一张表并写入一些数据：

create table client_user(    user_id         varchar(64)                              not null comment '用户唯一标示' primary key,    username        varchar(64)                              null comment '名称',    phone_number    varchar(64)                              null comment '手机号',    gender          tinyint(1) default 0                     null comment '0 未知 1 男 2 女  ')

对应的实体为：

package cn.felord.r2dbc.config;import lombok.Data;/** * @author felord.cn */@Datapublic class ClientUser {    private String userId;    private String username;    private String phoneNumber;    private Integer gender;}

然后我们编写一个Webflux的反应式接口：

package cn.felord.r2dbc.config;import org.springframework.data.r2dbc.core.DatabaseClient;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import reactor.core.publisher.Flux;import reactor.core.publisher.Mono;import javax.annotation.Resource;/** * The type User controller. * * @author felord.cn * @since 17 :07 */@RestController@RequestMapping("/user")public class UserController {    @Resource    private DatabaseClient databaseClient;    /**     * 查询     *     * @return 返回Flux序列 包含所有的ClientUser     */    @GetMapping("/get")    public Flux clientUserFlux() {        return databaseClient.execute("select * from client_user").as(ClientUser.class)                .fetch()                .all();    }    /**     * 响应式写入.     *     * @return Mono对象包含更新成功的条数     */    @GetMapping("/add")    public Mono insert() {        ClientUser clientUser = new ClientUser();        clientUser.setUserId("34345514644");        clientUser.setUsername("felord.cn");        clientUser.setPhoneNumber("3456121");        clientUser.setGender(1);        return databaseClient.insert().into(ClientUser.class)                .using(clientUser)                .fetch().rowsUpdated();    }}

调用接口就能获取到期望的数据结果。