|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Data Relational 3.4.0！ |
迁移指南
以下部分介绍如何迁移到较新版本的 Spring Data R2DBC。
从 1.1.x 升级到 1.2.x
Spring Data R2DBC 的开发目的是评估 R2DBC 与 Spring 应用程序的集成程度。
主要方面之一是，一旦 R2DBC 支持被证明是有用的，就将核心支持转移到 Spring Framework 中。
Spring Framework 5.3 附带了一个新模块：Spring R2DBC （spring-r2dbc).
spring-r2dbc提供核心 R2DBC 功能（一种DatabaseClient、事务管理器、连接工厂初始化、异常转换）最初由 Spring Data R2DBC 提供。
1.2.0 版本与 Spring R2DBC 中提供的内容保持一致，进行了以下各节中概述的几项更改。
Spring R2DBC 的DatabaseClient是一种更轻量级的实现，它封装了一个纯面向 SQL 的接口。
您将注意到，运行 SQL 语句的方法从DatabaseClient.execute(…)自DatabaseClient.sql(…).
用于 CRUD作的 Fluent API 已移至R2dbcEntityTemplate.
如果您通过 logger 前缀使用 SQL 语句的日志记录org.springframework.data.r2dbc，请确保将其更新为org.springframework.r2dbc（即删除.data） 指向 Spring R2DBC 组件。
弃用
-
弃用
o.s.d.r2dbc.core.DatabaseClient及其支持类ConnectionAccessor,FetchSpec,SqlProvider以及更多。 命名参数支持类，例如NamedParameterExpander由 Spring R2DBC 封装DatabaseClient实现，因此我们不提供替代品，因为这首先是内部 API。 用o.s.r2dbc.core.DatabaseClient及其 Spring R2DBC 替代品可从org.springframework.r2dbc.core. 基于实体的方法 （select/insert/update/delete） 方法可通过R2dbcEntityTemplate这是在 1.1 版本中引入的。 -
弃用
o.s.d.r2dbc.connectionfactory,o.s.d.r2dbc.connectionfactory.init和o.s.d.r2dbc.connectionfactory.lookup包。 使用 Spring R2DBC 的变体，您可以在o.s.r2dbc.connection. -
弃用
o.s.d.r2dbc.convert.ColumnMapRowMapper. 用o.s.r2dbc.core.ColumnMapRowMapper相反。 -
弃用绑定支持类
o.s.d.r2dbc.dialect.Bindings,BindMarker,BindMarkers,BindMarkersFactory和相关类型。 使用 替换org.springframework.r2dbc.core.binding. -
弃用
BadSqlGrammarException,UncategorizedR2dbcException和异常转换o.s.d.r2dbc.support. Spring R2DBC 提供了一个没有 SPI 的精简异常转换变体，现在可以通过以下方式使用o.s.r2dbc.connection.ConnectionFactoryUtils#convertR2dbcException.
使用 Spring R2DBC 提供的替换
为了简化迁移，一些已弃用的类型现在是 Spring R2DBC 提供的替代类型的子类型。 Spring Data R2DBC 更改了几种方法或引入了接受 Spring R2DBC 类型的新方法。 具体而言，更改了以下类：
-
R2dbcEntityTemplate -
R2dbcDialect -
类型
org.springframework.data.r2dbc.query
如果您直接使用这些类型，我们建议您查看并更新导入。