R2dbc Mybatis 整合

涉及到框架
  • r2dbc-spi
  • r2dbc-pool
  • reactor-core
  • mybatis
  • mybatis-dynamic-sql
  • spring-r2dbc
背景原因
  • 在介入Reactive技术栈时,将原有的mybatis框架 reactive 化的过程中,整合Transaction遇到的技术难点
  • 考察过社区很多 reactive 应用框架,除了Spring-R2DBC外,大部分事物处理,和connection管理,都还停留在阻塞式处理的思路中。并没有真正的实现reactive化
技术难点
  • 1 . 由于Reactive的编程模式相对于传统编程模式的变化,ThreadLocal已无法在reactive环境中使用,造成connection无法缓存,导致在业务流程上挂载事务处理时,无法缓存connection
  • 2 . 虽然r2dbc的connection提供了transaction操作,但要将mybatis框架 reactive 化的过程中,通过Context合理的缓存Connection不太好实现
背景知识
Reactive-Mybatis
  • 在整合r2dbcmybatis时,有一系列问题需要适配:

    • reactive项目中无法使用ThreadLocal,需要替换为Context,用于缓存Connection
    • reactive,属于数据流处理的形式,原有Mybatis中的处理逻辑是Blocking操作,需要替换为No-Blocking
    • 保留原有参数绑定和结果解析方案,并适配到reactive流处理过程中
    • r2dbc-spi驱动中,PreparedStatement中的占位符,不同驱动有不同的实现,而JDBC统一使用?为占位符,由驱动翻译占位符,这里需要转换为框架适配,否则适配不同的r2dbc驱动
    • 由于reactive本身就有cache性质,需要将mybatis中的cache剥离掉
    • 适配 r2dbc Data-Type,否则数据映射不成功
  • 在整合r2dbc事物时,需要使用动态代理来实现缓存ConnectionContext中,并保证,在一个事物中,Connection是同一个,这样才能实现Transaction
  • 在解析返回结果集时,需要切换思路,由于数据是按照数据流的形式返回的,那么在合并和解析结果集时,需要合理缓存已解析的数据,从而可以保留原有mybatis的一对多映射功能
  • 在适配SelectKey功能时,需要将原有的beforeafter操作,转移到executor中操作,原有的SelectKey功能是阻塞的,需要将流程贯穿到整个executor过程中,才能保留beforeafter操作
  • 由于r2dbc的限制,要么只返回自生成自增主键,要么返回影响行数
Reactive-Mybatis-Spring
  • 整合到Spring的过程中,需要将Executor挂在到Spring的事物管理器上,并交由Spring管理
  • Spring通过ConnectionFactoryUtils.currentConnectionFactory(connectionFactory)来判断,当前Context是否有事物管理
  • Spring提供了TransactionAwareConnectionFactoryProxy来代理事物,需要将ReactiveSqlSession中使用的ConnectionFactory替换为TransactionAwareConnectionFactoryProxy才能和Spring的事物管理器一起使用
相关信息
  • 已通过Mybatis源码,适配了R2DBC,保留Mybatis原用功能,尽可能的保证项目顺利迁移。具体支持的功能,请移步 reactive-mybatis-support
  • 已发布到中央仓库,测试了MySQL / PostgreSQL/H2/Mssql/Oracle
相关源码维护在GitHub,欢迎Issue和Star reactive-mybatis-support

Cheng_Gang
99 声望14 粉丝