Spring Boot 4

可在 1.8.0 中使用。 Spring Boot 集成以 starter 和单独发布的 auto-configuration 模块这两个 artifact 发布在 Maven Central。

依赖

将 r2d1-spring-boot-starter artifact 添加到运行 Java 21 或更高版本的 Spring Boot 4.0.6 应用程序中：

dependencies {
    implementation("dev.nexcraft:r2d1-spring-boot-starter:1.8.0")
}

starter 依赖于单独发布的 r2d1-spring-boot-autoconfigure 模块。普通应用程序请使用 starter；组合自定义 starter 时，可以直接使用 auto-configuration 模块。

配置内容

设置 r2d1.enabled=true 即可启用集成。该配置支持 R2 或 filesystem 文档存储，以及 D1 或 JDBC 索引，同时保留与框架无关的 R2D1 集合 API。

JDBC 默认使用平台线程执行。仅在 Java 25 运行时上显式选择虚拟线程执行；该集成不会为更早的运行时提供回退。

资源所有权

应用程序已有的 DataSource, Executor, S3AsyncClient, 以及 HttpClient bean 会在按名称选中、作为唯一 bean 或 @Primary bean 时被复用。集成不会关闭应用程序拥有的资源。集成创建的资源会随其托管 bean 一起关闭。

范围

Spring Data repository、事务、AOP、controller、重试和补偿策略、R2DBC、服务器生命周期以及连接池管理不在这些模块的范围内。在验证具体的 Spring AOT 需求之前，不包含 native-image hints。