迁移指南
以下部分说明了如何迁移到更新版本的 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 操作的流畅 API 已移至 R2dbcEntityTemplate
。
如果您通过日志前缀 org.springframework.data.r2dbc
记录 SQL 语句,请确保将其更新为 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
及其从org.springframework.r2dbc.core
获得的 Spring R2DBC 替换。基于实体的方法(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
中的类型
如果您直接使用这些类型,建议您查看并更新您的导入。