MariaDB Connector/R2DBC 使用教程

最新推荐文章于 2025-04-26 06:00:00 发布

赵鹰伟Meadow

最新推荐文章于 2025-04-26 06:00:00 发布

阅读量411

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00017/article/details/136929593

LivorassBlog是一个由开发者维护的开源项目，提供技术文章、教程和学习资源。项目采用Markdown格式，利用Git进行版本控制，鼓励互动和社区贡献，是学习者和开发者获取技术知识的全方位平台。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

MariaDB Connector/R2DBC 使用教程

mariadb-connector-r2dbc 项目地址: https://gitcode.com/gh_mirrors/ma/mariadb-connector-r2dbc

1. 项目介绍

MariaDB Connector/R2DBC 是一个用于 Java 的非阻塞 MariaDB 和 MySQL 客户端连接器，完全兼容 Java 8+，并且遵循 Apache 2.0 许可证。该连接器支持 R2DBC 1.0.0 规范，允许开发者使用 Reactive 编程模型与 MariaDB 数据库进行交互。它还支持多种高级功能，如 ed25519 和 PAM 认证、MariaDB 10.5 的返回函数等。

2. 项目快速启动

2.1 添加依赖

首先，在 Maven 项目中添加 MariaDB Connector/R2DBC 的依赖：

<dependency>
    <groupId>org.mariadb</groupId>
    <artifactId>r2dbc-mariadb</artifactId>
    <version>1.2.2</version>
</dependency>

2.2 配置连接

使用 MariadbConnectionConfiguration 配置连接参数：

import org.mariadb.r2dbc.MariadbConnectionConfiguration;
import org.mariadb.r2dbc.MariadbConnectionFactory;

MariadbConnectionConfiguration conf = MariadbConnectionConfiguration.builder()
    .host("localhost")
    .port(3306)
    .username("myUser")
    .password("MySuperPassword")
    .database("db")
    .build();

MariadbConnectionFactory factory = new MariadbConnectionFactory(conf);

2.3 执行查询

使用配置好的连接工厂执行 SQL 查询：

import org.mariadb.r2dbc.api.MariadbConnection;

MariadbConnection connection = factory.create().block();
connection.createStatement("SELECT * FROM myTable WHERE val = ?")
    .bind(0, "myVal") // 设置参数
    .execute()
    .flatMap(r -> r.map((row, metadata) -> {
        return "value=" + row.get(0, String.class);
    }))
    .subscribe();

connection.close().subscribe();

3. 应用案例和最佳实践

3.1 使用 Spring Data R2DBC

MariaDB Connector/R2DBC 可以与 Spring Data R2DBC 结合使用，实现响应式数据库访问。以下是一个简单的 Spring Boot 应用示例：

@Configuration
public class DatabaseConfig {

    @Bean
    public ConnectionFactory connectionFactory() {
        return ConnectionFactories.get("r2dbc:mariadb://user:password@localhost:3306/myDB");
    }

    @Bean
    public R2dbcEntityTemplate r2dbcEntityTemplate(ConnectionFactory connectionFactory) {
        return new R2dbcEntityTemplate(connectionFactory);
    }
}

3.2 高级功能

MariaDB Connector/R2DBC 支持多种高级功能，如多主机连接、SSL 加密、PAM 认证等。以下是一个使用 SSL 连接的示例：

MariadbConnectionConfiguration conf = MariadbConnectionConfiguration.builder()
    .host("localhost")
    .port(3306)
    .username("myUser")
    .password("MySuperPassword")
    .database("db")
    .sslMode(SslMode.VERIFY_CA)
    .serverSslCert("/path/to/server-cert.pem")
    .build();