迁移指南
以下部分介绍如何迁移到较新版本的 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
如果您直接使用这些类型,我们建议您查看和更新导入。