Reactive Mybatis Support

JDK/R2DBC-SPI/Spring-Boot Compatibility

• Refer to the table below to determine the appropriate version of mybatis-r2dbc for your project.

Exclude the v prefix when using the version number.

Compiled JDK	8	17
r2dbc-spi	0.9.1.RELEASE	1.0.0.RELEASE
mybatis-r2dbc
mybatis-r2dbc-generator
mybatis-r2dbc-spring
Spring Boot	[2.7.x,3.0.0)	[3.0.0,~)

• The whole project reactive-mybatis-support(2.x.x) is compiled with JDK8 and SpringBoot(2.7.x), aka r2dbc-spi(0.9.1.RELEASE)
• The mybatis-r2dbc(3.0.x) and mybatis-r2dbc-generator(3.0.x) are compiled with JDK11, aka r2dbc-spi(1.0.0.RELEASE).
• Since 3.1.0 the mybatis-r2dbc and mybatis-r2dbc-generator and mybatis-r2dbc-spring are compiled with JDK17, and SpringBoot(3.x.x),aka r2dbc-spi(1.0.0.RELEASE).

Instruction

• Reactive Mybatis Support is aimed to adapt original mybatis to reactive project (aka WebFlux/Reactor3) with r2dbc drivers.
• mybatis-r2dbc module is inspired by linux-china/mybatis-r2dbc and based on mybatis3's original source code.
• mybatis-generator module is used to generate mybatis-dynamic-sql code with reactive types.
• Most of the MyBatis3 features are applicable, but there are a few features that are not supported:
  • ❌ 1 . mybatis-plugin
  • ❌ 2 . multi ResultSets or Results
  • ❌ 3 . nested query with multi SQL statements
  • ❌️ 4 . blocking java type (aka: InputStream .eg)
• For more usage instructions, please refer to the wiki: WIKI

Maven Central

• dependency

<dependencies>
    <dependency>
        <groupId>pro.chenggang</groupId>
        <artifactId>mybatis-r2dbc</artifactId>
        <version>${compatible-version}</version>
    </dependency>
    <dependency>
        <groupId>pro.chenggang</groupId>
        <artifactId>mybatis-r2dbc-generator</artifactId>
        <version>${compatible-version}</version>
    </dependency>
    <dependency>
        <groupId>pro.chenggang</groupId>
        <artifactId>mybatis-r2dbc-spring</artifactId>
        <version>${compatible-version}</version>
    </dependency>
</dependencies>

Reference

• 1. mybatis/mybatis3
• 2. mybatis/mybatis-dynamic-sql
• 3. linux-china/mybatis-r2dbc
• 4. DefaultDatabaseClient