对于最新的稳定版本，请使用 Spring Data Relational 3.4.0！spring-doc.cn

迁移指南

以下部分介绍如何迁移到较新版本的 Spring Data R2DBC。spring-doc.cn

从 1.1.x 升级到 1.2.x

Spring Data R2DBC 的开发目的是评估 R2DBC 与 Spring 应用程序的集成程度。 主要方面之一是，一旦 R2DBC 支持被证明是有用的，就将核心支持转移到 Spring Framework 中。 Spring Framework 5.3 附带了一个新模块：Spring R2DBC （）。spring-r2dbcspring-doc.cn

spring-r2dbc附带最初由 Spring Data R2DBC 提供的核心 R2DBC 功能（事务管理器、连接工厂初始化、异常转换的 Slim 变体）。 1.2.0 版本与 Spring R2DBC 中提供的内容保持一致，进行了以下各节中概述的几项更改。DatabaseClientspring-doc.cn

Spring R2DBC 是一个更轻量级的实现，它封装了一个纯面向 SQL 的接口。 您会注意到，运行 SQL 语句的方法从 更改为 。 用于 CRUD 操作的 Fluent API 已移至 .DatabaseClientDatabaseClient.execute(…)DatabaseClient.sql(…)R2dbcEntityTemplatespring-doc.cn

如果您通过 logger prefix 使用SQL语句的日志记录，请确保将其更新为（即删除）以指向Spring R2DBC组件。org.springframework.data.r2dbcorg.springframework.r2dbc.dataspring-doc.cn

弃用

  • 弃用 及其支持类 、 、 等等。 命名参数支持类（例如）是由 Spring R2DBC 的实现封装的，因此我们不提供替代品，因为这首先是内部 API。 使用及其 Spring R2DBC 替代品可从 获得。 基于实体的方法 （///） 方法可通过 1.1 版引入。o.s.d.r2dbc.core.DatabaseClientConnectionAccessorFetchSpecSqlProviderNamedParameterExpanderDatabaseCliento.s.r2dbc.core.DatabaseClientorg.springframework.r2dbc.coreselectinsertupdatedeleteR2dbcEntityTemplatespring-doc.cn

  • 弃用 、 和 包。 使用 Spring R2DBC 的变体，您可以在 .o.s.d.r2dbc.connectionfactoryo.s.d.r2dbc.connectionfactory.inito.s.d.r2dbc.connectionfactory.lookupo.s.r2dbc.connectionspring-doc.cn

  • 废弃 . 请改用。o.s.d.r2dbc.convert.ColumnMapRowMappero.s.r2dbc.core.ColumnMapRowMapperspring-doc.cn

  • 弃用绑定支持类 、 、 和相关类型。 使用 中的 替换项。o.s.d.r2dbc.dialect.BindingsBindMarkerBindMarkersBindMarkersFactoryorg.springframework.r2dbc.core.bindingspring-doc.cn

  • 弃用 ，并在 处进行异常转换。 Spring R2DBC 提供了一个没有 SPI 的精简异常转换变体，现在可以通过 .BadSqlGrammarExceptionUncategorizedR2dbcExceptiono.s.d.r2dbc.supporto.s.r2dbc.connection.ConnectionFactoryUtils#convertR2dbcExceptionspring-doc.cn

使用 Spring R2DBC 提供的替换

为了简化迁移，一些已弃用的类型现在是 Spring R2DBC 提供的替代类型的子类型。 Spring Data R2DBC 更改了几种方法或引入了接受 Spring R2DBC 类型的新方法。 具体而言，更改了以下类：spring-doc.cn

如果您直接使用这些类型，我们建议您查看并更新导入。spring-doc.cn

重大更改

  • OutboundRow和语句映射器从 using 切换到SettableValueParameterspring-doc.cn

  • 存储库工厂支持需要而不是 .o.s.r2dbc.core.DatabaseCliento.s.data.r2dbc.core.DatabaseClientspring-doc.cn

依赖项更改

要使用 Spring R2DBC，请确保包含以下依赖项：spring-doc.cn