MariaDB Connector/R2DBC
This page is part of MariaDB's Documentation.
The parent of this page is: MariaDB Connectors
Topics on this page:
Overview
Java developers can use MariaDB Connector/R2DBC to connect to MariaDB database products using the Reactive Relational Database Connectivity (R2DBC) API. R2DBC operations are non-blocking, which makes the R2DBC API more scalable than Java's standard JDBC API. MariaDB Connector/R2DBC is available both with a native R2DBC implementation and the Spring Data R2DBC framework.
Connector | MariaDB Connector/R2DBC |
---|---|
Supported Versions | 1.2 |
Programming Language | Java |
Programming Language Version | Java 8+ |
API | |
Supports TLS | Yes |
Supports Connection Pools | Yes |
License | Apache 2.0 |
End of Life (EOL) Versions
The following versions of MariaDB Connector/R2DBC have reached End of Life and are no longer supported:
MariaDB Connector/R2DBC 1.0
MariaDB Connector/R2DBC 1.1
Users are encouraged to upgrade to the next available supported version.
Maven artifacts
Current connector supporting 1.0.0 R2DBC spec is:
<dependency> <groupId>org.mariadb</groupId> <artifactId>r2dbc-mariadb</artifactId> <version>1.2.x</version> </dependency>
In order to support R2DBC 0.9.1 spec that is incompatible with 1.0.0 spec:
<dependency> <groupId>org.mariadb</groupId> <artifactId>r2dbc-mariadb-0.9.1-spec</artifactId> <version>1.2.x</version> </dependency>
Benefits of R2DBC
The R2DBC API relies on reactive data streams, which provide many benefits over standard JDBC:
Reactive: R2DBC uses an event-driven, non-blocking, and functional programming model.
Scalable: R2DBC is more scalable than standard JDBC, because it allows the runtime to handle concurrency and scheduling.
Fast: R2DBC streams results, which can improve performance.
Efficient: R2DBC uses deferred execution and flow control to ensure that operations are performed efficiently.
Simple: R2DBC is designed to make common usage patterns simple to implement for developers.
Framework-Specific Documentation
For details on how to use MariaDB Connector/R2DBC, choose a supported framework:
The native implementation of R2DBC can be used to connect using MariaDB Connector/R2DBC from within your Java application. | |
Spring Data implementation of R2DBC allows you to connect using MariaDB Connector/R2DBC using the Spring Framework. |
Feature | ||
---|---|---|
Reactive | Yes | Yes |
Scalable | Yes | Yes |
Fast | Yes | Yes |
Efficient | Yes | Yes |
Executes SQL | Yes | Yes |
Integrates with Spring Framework | No | Yes |
Spring Data: | No | Yes |
Spring Data: Repositories | No | Yes |
Spring Data: Object Mapping | No | Yes |
Spring Data: Transaction Management | No | Yes |