diff --git a/spring-data-r2dbc/.github/PULL_REQUEST_TEMPLATE.md b/spring-data-r2dbc/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 00000000..e8f632af
--- /dev/null
+++ b/spring-data-r2dbc/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,11 @@
+
+
+- [ ] You have read the [Spring Data contribution guidelines](https://github.com/spring-projects/spring-data-build/blob/master/CONTRIBUTING.adoc).
+- [ ] You use the code formatters provided [here](https://github.com/spring-projects/spring-data-build/tree/master/etc/ide) and have them applied to your changes. Don’t submit any formatting related changes.
+- [ ] You submit test cases (unit or integration tests) that back your changes.
+- [ ] You added yourself as author in the headers of the classes you touched. Amend the date range in the Apache license header if needed. For new types, add the license header (copy from another file and set the current year only).
diff --git a/spring-data-r2dbc/.github/workflows/project.yml b/spring-data-r2dbc/.github/workflows/project.yml
new file mode 100644
index 00000000..60622652
--- /dev/null
+++ b/spring-data-r2dbc/.github/workflows/project.yml
@@ -0,0 +1,47 @@
+# GitHub Actions to automate GitHub issues for Spring Data Project Management
+
+name: Spring Data GitHub Issues
+
+on:
+ issues:
+ types: [opened, edited, reopened]
+ issue_comment:
+ types: [created]
+ pull_request_target:
+ types: [opened, edited, reopened]
+
+jobs:
+ Inbox:
+ runs-on: ubuntu-latest
+ if: github.repository_owner == 'spring-projects' && (github.event.action == 'opened' || github.event.action == 'reopened') && github.event.pull_request == null
+ steps:
+ - name: Create or Update Issue Card
+ uses: peter-evans/create-or-update-project-card@v1.1.2
+ with:
+ project-name: 'Spring Data'
+ column-name: 'Inbox'
+ project-location: 'spring-projects'
+ token: ${{ secrets.GH_ISSUES_TOKEN_SPRING_DATA }}
+ Pull-Request:
+ runs-on: ubuntu-latest
+ if: github.repository_owner == 'spring-projects' && (github.event.action == 'opened' || github.event.action == 'reopened') && github.event.pull_request != null
+ steps:
+ - name: Create or Update Pull Request Card
+ uses: peter-evans/create-or-update-project-card@v1.1.2
+ with:
+ project-name: 'Spring Data'
+ column-name: 'Review pending'
+ project-location: 'spring-projects'
+ issue-number: ${{ github.event.pull_request.number }}
+ token: ${{ secrets.GH_ISSUES_TOKEN_SPRING_DATA }}
+ Feedback-Provided:
+ runs-on: ubuntu-latest
+ if: github.repository_owner == 'spring-projects' && github.event_name == 'issue_comment' && github.event.action == 'created' && github.actor != 'spring-projects-issues' && github.event.pull_request == null && github.event.issue.state == 'open' && contains(toJSON(github.event.issue.labels), 'waiting-for-feedback')
+ steps:
+ - name: Update Project Card
+ uses: peter-evans/create-or-update-project-card@v1.1.2
+ with:
+ project-name: 'Spring Data'
+ column-name: 'Feedback provided'
+ project-location: 'spring-projects'
+ token: ${{ secrets.GH_ISSUES_TOKEN_SPRING_DATA }}
diff --git a/spring-data-r2dbc/.gitignore b/spring-data-r2dbc/.gitignore
new file mode 100644
index 00000000..f339c61b
--- /dev/null
+++ b/spring-data-r2dbc/.gitignore
@@ -0,0 +1,12 @@
+target/
+.idea/
+.settings/
+*.iml
+.flattened-pom.xml
+.project
+.classpath
+.springBeans
+.sonar4clipse
+*.sonar4clipseExternals
+*.graphml
+*.json
diff --git a/spring-data-r2dbc/.mvn/wrapper/maven-wrapper.jar b/spring-data-r2dbc/.mvn/wrapper/maven-wrapper.jar
new file mode 100755
index 00000000..01e67997
Binary files /dev/null and b/spring-data-r2dbc/.mvn/wrapper/maven-wrapper.jar differ
diff --git a/spring-data-r2dbc/.mvn/wrapper/maven-wrapper.properties b/spring-data-r2dbc/.mvn/wrapper/maven-wrapper.properties
new file mode 100755
index 00000000..84fe0f88
--- /dev/null
+++ b/spring-data-r2dbc/.mvn/wrapper/maven-wrapper.properties
@@ -0,0 +1,2 @@
+#Mon Oct 11 14:30:22 CEST 2021
+distributionUrl=https\://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.3/apache-maven-3.8.3-bin.zip
diff --git a/spring-data-r2dbc/CI.adoc b/spring-data-r2dbc/CI.adoc
new file mode 100644
index 00000000..d0f0478e
--- /dev/null
+++ b/spring-data-r2dbc/CI.adoc
@@ -0,0 +1,29 @@
+= Continuous Integration
+
+image:https://jenkins.spring.io/buildStatus/icon?job=spring-data-r2dbc%2Fmain&subject=main["Spring Data R2DBC", link="https://jenkins.spring.io/view/SpringData/job/spring-data-r2dbc/"]
+
+== Running CI tasks locally
+
+Since this pipeline is purely Docker-based, it's easy to:
+
+* Debug what went wrong on your local machine.
+* Test out a a tweak to your `test.sh` script before sending it out.
+* Experiment against a new image before submitting your pull request.
+
+All of these use cases are great reasons to essentially run what the CI server does on your local machine.
+
+IMPORTANT: To do this you must have Docker installed on your machine.
+
+1. `docker run -it --mount type=bind,source="$(pwd)",target=/spring-data-r2dbc-github -v /usr/bin/docker:/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock adoptopenjdk/openjdk8:latest /bin/bash`
++
+This will launch the Docker image and mount your source code at `spring-data-r2dbc-github`.
++
+2. `cd spring-data-r2dbc-github`
++
+Next, test everything from inside the container:
++
+3. `./mvnw -Pci,all-dbs clean dependency:list test -Dsort -B` (or whatever test configuration you must use)
+
+Since the container is binding to your source, you can make edits from your IDE and continue to run build jobs.
+
+NOTE: Docker containers can eat up disk space fast! From time to time, run `docker system prune` to clean out old images.
diff --git a/spring-data-r2dbc/CONTRIBUTING.adoc b/spring-data-r2dbc/CONTRIBUTING.adoc
new file mode 100644
index 00000000..740e8bd0
--- /dev/null
+++ b/spring-data-r2dbc/CONTRIBUTING.adoc
@@ -0,0 +1,3 @@
+= Spring Data contribution guidelines
+
+You find the contribution guidelines for Spring Data projects https://github.com/spring-projects/spring-data-build/blob/main/CONTRIBUTING.adoc[here].
diff --git a/spring-data-r2dbc/Jenkinsfile b/spring-data-r2dbc/Jenkinsfile
new file mode 100644
index 00000000..d3885a6f
--- /dev/null
+++ b/spring-data-r2dbc/Jenkinsfile
@@ -0,0 +1,103 @@
+def p = [:]
+node {
+ checkout scm
+ p = readProperties interpolate: true, file: 'ci/pipeline.properties'
+}
+
+pipeline {
+ agent none
+
+ triggers {
+ pollSCM 'H/10 * * * *'
+ upstream(upstreamProjects: "spring-data-commons/3.0.x,spring-data-jdbc/3.0.x", threshold: hudson.model.Result.SUCCESS)
+ }
+
+ options {
+ disableConcurrentBuilds()
+ buildDiscarder(logRotator(numToKeepStr: '14'))
+ }
+
+ stages {
+ stage("test: baseline (Java 17)") {
+ when {
+ beforeAgent(true)
+ anyOf {
+ branch(pattern: "main|(\\d\\.\\d\\.x)", comparator: "REGEXP")
+ not { triggeredBy 'UpstreamCause' }
+ }
+ }
+ agent {
+ label 'data'
+ }
+ options { timeout(time: 30, unit: 'MINUTES') }
+
+ environment {
+ DOCKER_HUB = credentials('hub.docker.com-springbuildmaster')
+ ARTIFACTORY = credentials('02bd1690-b54f-4c9f-819d-a77cb7a9822c')
+ }
+
+ steps {
+ script {
+ docker.withRegistry(p['docker.registry'], p['docker.credentials']) {
+ docker.image(p['docker.java.main.image']).inside(p['docker.java.inside.docker']) {
+ sh "docker login --username ${DOCKER_HUB_USR} --password ${DOCKER_HUB_PSW}"
+ sh 'PROFILE=ci ci/test.sh'
+ sh "ci/clean.sh"
+ }
+ }
+ }
+ }
+ }
+
+ stage('Release to artifactory') {
+ when {
+ beforeAgent(true)
+ anyOf {
+ branch(pattern: "main|(\\d\\.\\d\\.x)", comparator: "REGEXP")
+ not { triggeredBy 'UpstreamCause' }
+ }
+ }
+ agent {
+ label 'data'
+ }
+ options { timeout(time: 20, unit: 'MINUTES') }
+
+ environment {
+ ARTIFACTORY = credentials('02bd1690-b54f-4c9f-819d-a77cb7a9822c')
+ }
+
+ steps {
+ script {
+ docker.withRegistry(p['docker.registry'], p['docker.credentials']) {
+ docker.image(p['docker.java.main.image']).inside(p['docker.java.inside.basic']) {
+ sh 'MAVEN_OPTS="-Duser.name=jenkins -Duser.home=/tmp/jenkins-home" ./mvnw -s settings.xml -Pci,artifactory -Dmaven.repo.local=/tmp/jenkins-home/.m2/spring-data-r2dbc-non-root ' +
+ '-Dartifactory.server=https://repo.spring.io ' +
+ "-Dartifactory.username=${ARTIFACTORY_USR} " +
+ "-Dartifactory.password=${ARTIFACTORY_PSW} " +
+ "-Dartifactory.staging-repository=libs-snapshot-local " +
+ "-Dartifactory.build-name=spring-data-r2dbc " +
+ "-Dartifactory.build-number=${BUILD_NUMBER} " +
+ '-Dmaven.test.skip=true clean deploy -U -B'
+ }
+ }
+ }
+ }
+ }
+ }
+
+ post {
+ changed {
+ script {
+ slackSend(
+ color: (currentBuild.currentResult == 'SUCCESS') ? 'good' : 'danger',
+ channel: '#spring-data-dev',
+ message: "${currentBuild.fullDisplayName} - `${currentBuild.currentResult}`\n${env.BUILD_URL}")
+ emailext(
+ subject: "[${currentBuild.fullDisplayName}] ${currentBuild.currentResult}",
+ mimeType: 'text/html',
+ recipientProviders: [[$class: 'CulpritsRecipientProvider'], [$class: 'RequesterRecipientProvider']],
+ body: "${currentBuild.fullDisplayName} is reported as ${currentBuild.currentResult}")
+ }
+ }
+ }
+}
diff --git a/spring-data-r2dbc/LICENSE.txt b/spring-data-r2dbc/LICENSE.txt
new file mode 100644
index 00000000..ff773796
--- /dev/null
+++ b/spring-data-r2dbc/LICENSE.txt
@@ -0,0 +1,202 @@
+
+ Apache License
+ Version 2.0, January 2004
+ https://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "{}"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright {yyyy} {name of copyright owner}
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/spring-data-r2dbc/README.adoc b/spring-data-r2dbc/README.adoc
new file mode 100644
index 00000000..247f4d5b
--- /dev/null
+++ b/spring-data-r2dbc/README.adoc
@@ -0,0 +1,158 @@
+image:https://spring.io/badges/spring-data-r2dbc/snapshot.svg["Spring Data R2DBC", link="https://spring.io/projects/spring-data-r2dbc#learn"]
+
+= Spring Data R2DBC image:https://jenkins.spring.io/buildStatus/icon?job=spring-data-r2dbc%2Fmain&subject=Build[link=https://jenkins.spring.io/view/SpringData/job/spring-data-r2dbc/] https://gitter.im/spring-projects/spring-data[image:https://badges.gitter.im/spring-projects/spring-data.svg[Gitter]]
+
+The primary goal of the https://projects.spring.io/spring-data[Spring Data] project is to make it easier to build Spring-powered applications that use data access technologies. *Spring Data R2DBC* offers the popular Repository abstraction based on https://r2dbc.io[R2DBC].
+
+R2DBC is the abbreviation for https://github.com/r2dbc/[Reactive Relational Database Connectivity], an incubator to integrate relational databases using a reactive driver.
+
+== This is NOT an ORM
+
+Spring Data R2DBC aims at being conceptually easy. In order to achieve this it does NOT offer caching, lazy loading, write behind or many other features of ORM frameworks. This makes Spring Data R2DBC a simple, limited, opinionated object mapper.
+
+== Features
+
+* Spring configuration support using Java based `@Configuration` classes.
+* Annotation based mapping metadata.
+* Automatic implementation of Repository interfaces including support.
+* Support for Reactive Transactions
+* Schema and data initialization utilities.
+
+== Code of Conduct
+
+This project is governed by the https://github.com/spring-projects/.github/blob/e3cc2ff230d8f1dca06535aa6b5a4a23815861d4/CODE_OF_CONDUCT.md[Spring Code of Conduct]. By participating, you are expected to uphold this code of conduct. Please report unacceptable behavior to spring-code-of-conduct@pivotal.io.
+
+== Getting Started
+
+Here is a quick teaser of an application using Spring Data Repositories in Java:
+
+[source,java]
+----
+public interface PersonRepository extends ReactiveCrudRepository {
+
+ @Query("SELECT * FROM person WHERE lastname = :lastname")
+ Flux findByLastname(String lastname);
+
+ @Query("SELECT * FROM person WHERE firstname LIKE :firstname")
+ Flux findByFirstnameLike(String firstname);
+}
+
+@Service
+public class MyService {
+
+ private final PersonRepository repository;
+
+ public MyService(PersonRepository repository) {
+ this.repository = repository;
+ }
+
+ public void doWork() {
+
+ repository.deleteAll().block();
+
+ Person person = new Person();
+ person.setFirstname("Mark");
+ person.setLastname("Paluch");
+ repository.save(person).block();
+
+ Flux lastNameResults = repository.findByLastname("Paluch");
+ Flux firstNameResults = repository.findByFirstnameLike("M%");
+ }
+}
+
+@Configuration
+@EnableR2dbcRepositories
+class ApplicationConfig extends AbstractR2dbcConfiguration {
+
+ @Bean
+ public ConnectionFactory connectionFactory() {
+ return ConnectionFactories.get("r2dbc:h2:mem:///test?options=DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE");
+ }
+}
+----
+
+=== Maven configuration
+
+Add the Maven dependency:
+
+[source,xml]
+----
+
+ org.springframework.data
+ spring-data-r2dbc
+ ${version}
+
+----
+
+If you'd rather like the latest snapshots of the upcoming major version, use our Maven snapshot repository and declare the appropriate dependency version.
+
+[source,xml]
+----
+
+ org.springframework.data
+ spring-data-r2dbc
+ ${version}-SNAPSHOT
+
+
+
+ spring-libs-snapshot
+ Spring Snapshot Repository
+ https://repo.spring.io/libs-snapshot
+
+----
+
+== Getting Help
+
+Having trouble with Spring Data? We’d love to help!
+
+* Check the
+https://docs.spring.io/spring-data/r2dbc/docs/1.0.x/reference/html/#reference[reference documentation], and https://docs.spring.io/spring-data/r2dbc/docs/1.0.x/api/[Javadocs].
+* Learn the Spring basics – Spring Data builds on Spring Framework, check the https://spring.io[spring.io] web-site for a wealth of reference documentation.
+If you are just starting out with Spring, try one of the https://spring.io/guides[guides].
+* If you are upgrading, check out the https://docs.spring.io/spring-data/r2dbc/docs/current/changelog.txt[changelog] for "`new and noteworthy`" features.
+* Ask a question - we monitor https://stackoverflow.com[stackoverflow.com] for questions tagged with https://stackoverflow.com/tags/spring-data-r2dbc[`spring-data-r2dbc`].
+* Report bugs with Spring Data R2DBC at https://github.com/spring-projects/spring-data-r2dbc/issues[github.com/spring-projects/spring-data-r2dbc/issues].
+
+== Reporting Issues
+
+Spring Data uses GitHub as issue tracking system to record bugs and feature requests. If you want to raise an issue, please follow the recommendations below:
+
+* Before you log a bug, please search the
+https://github.com/spring-projects/spring-data-r2dbc/issues[issue tracker] to see if someone has already reported the problem.
+* If the issue does not already exist, https://github.com/spring-projects/spring-data-r2dbc/issues/new[create a new issue].
+* Please provide as much information as possible with the issue report, we like to know the version of Spring Data that you are using and JVM version.
+* If you need to paste code, or include a stack trace use Markdown +++```+++ escapes before and after your text.
+* If possible try to create a test-case or project that replicates the issue. Attach a link to your code or a compressed file containing your code.
+
+== Building from Source
+
+You don’t need to build from source to use Spring Data (binaries in https://repo.spring.io[repo.spring.io]), but if you want to try out the latest and greatest, Spring Data can be easily built with the https://github.com/takari/maven-wrapper[maven wrapper].
+You also need JDK 1.8.
+
+[source,bash]
+----
+ $ ./mvnw clean install
+----
+
+If you want to build with the regular `mvn` command, you will need https://maven.apache.org/run-maven/index.html[Maven v3.5.0 or above].
+
+_Also see link:CONTRIBUTING.adoc[CONTRIBUTING.adoc] if you wish to submit pull requests, and in particular please sign the https://cla.pivotal.io/sign/spring[Contributor’s Agreement] before your first non-trivial change._
+
+=== Building reference documentation
+
+Building the documentation builds also the project without running tests.
+
+[source,bash]
+----
+ $ ./mvnw clean install -Pdistribute
+----
+
+The generated documentation is available from `target/site/reference/html/index.html`.
+
+== Examples
+
+* https://github.com/spring-projects/spring-data-examples/[Spring Data Examples] contains example projects that explain specific features in more detail.
+
+== License
+
+Spring Data R2DBC is Open Source software released under the https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 license].
diff --git a/spring-data-r2dbc/SECURITY.adoc b/spring-data-r2dbc/SECURITY.adoc
new file mode 100644
index 00000000..3f9ccf7a
--- /dev/null
+++ b/spring-data-r2dbc/SECURITY.adoc
@@ -0,0 +1,9 @@
+# Security Policy
+
+## Supported Versions
+
+Please see the https://spring.io/projects/spring-data-r2dbc[Spring Data R2DBC] project page for supported versions.
+
+## Reporting a Vulnerability
+
+Please don't raise security vulnerabilities here. Head over to https://pivotal.io/security to learn how to disclose them responsibly.
diff --git a/spring-data-r2dbc/ci/clean.sh b/spring-data-r2dbc/ci/clean.sh
new file mode 100755
index 00000000..f45d0f5f
--- /dev/null
+++ b/spring-data-r2dbc/ci/clean.sh
@@ -0,0 +1,6 @@
+#!/bin/bash -x
+
+set -euo pipefail
+
+MAVEN_OPTS="-Duser.name=jenkins -Duser.home=/tmp/jenkins-home" \
+ ./mvnw -s settings.xml clean -Dmaven.repo.local=/tmp/jenkins-home/.m2/spring-data-r2dbc
diff --git a/spring-data-r2dbc/ci/pipeline.properties b/spring-data-r2dbc/ci/pipeline.properties
new file mode 100644
index 00000000..60ce02f4
--- /dev/null
+++ b/spring-data-r2dbc/ci/pipeline.properties
@@ -0,0 +1,24 @@
+# Java versions
+java.main.tag=17.0.2_8-jdk
+
+# Docker container images - standard
+docker.java.main.image=harbor-repo.vmware.com/dockerhub-proxy-cache/library/eclipse-temurin:${java.main.tag}
+
+# Supported versions of MongoDB
+docker.mongodb.4.4.version=4.4.4
+docker.mongodb.5.0.version=5.0.3
+
+# Supported versions of Redis
+docker.redis.6.version=6.2.4
+
+# Supported versions of Cassandra
+docker.cassandra.3.version=3.11.11
+
+# Docker environment settings
+docker.java.inside.basic=-v $HOME:/tmp/jenkins-home
+docker.java.inside.docker=-u root -v /var/run/docker.sock:/var/run/docker.sock -v /usr/bin/docker:/usr/bin/docker -v $HOME:/tmp/jenkins-home
+
+# Credentials
+docker.registry=
+docker.credentials=hub.docker.com-springbuildmaster
+artifactory.credentials=02bd1690-b54f-4c9f-819d-a77cb7a9822c
diff --git a/spring-data-r2dbc/ci/test.sh b/spring-data-r2dbc/ci/test.sh
new file mode 100755
index 00000000..0c4b3892
--- /dev/null
+++ b/spring-data-r2dbc/ci/test.sh
@@ -0,0 +1,10 @@
+#!/bin/bash -x
+
+set -euo pipefail
+
+mkdir -p /tmp/jenkins-home/.m2/spring-data-r2dbc
+chown -R 1001:1001 .
+
+MAVEN_OPTS="-Duser.name=jenkins -Duser.home=/tmp/jenkins-home" \
+ ./mvnw -s settings.xml \
+ -P${PROFILE} clean dependency:list test -Dsort -U -B -Dmaven.repo.local=/tmp/jenkins-home/.m2/spring-data-r2dbc
\ No newline at end of file
diff --git a/spring-data-r2dbc/docs/favicon.png b/spring-data-r2dbc/docs/favicon.png
new file mode 100644
index 00000000..890ef063
Binary files /dev/null and b/spring-data-r2dbc/docs/favicon.png differ
diff --git a/spring-data-r2dbc/docs/index.html b/spring-data-r2dbc/docs/index.html
new file mode 100644
index 00000000..7b9c255e
--- /dev/null
+++ b/spring-data-r2dbc/docs/index.html
@@ -0,0 +1,11 @@
+
+
+
+ Redirecting…
+
+
+
+
Redirecting…
+ Click here if you are not redirected.
+
+
diff --git a/spring-data-r2dbc/lombok.config b/spring-data-r2dbc/lombok.config
new file mode 100644
index 00000000..e50c7ea4
--- /dev/null
+++ b/spring-data-r2dbc/lombok.config
@@ -0,0 +1,2 @@
+lombok.nonNull.exceptionType = IllegalArgumentException
+lombok.log.fieldName = LOG
diff --git a/spring-data-r2dbc/mvnw b/spring-data-r2dbc/mvnw
new file mode 100755
index 00000000..5551fde8
--- /dev/null
+++ b/spring-data-r2dbc/mvnw
@@ -0,0 +1,286 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Maven2 Start Up Batch script
+#
+# Required ENV vars:
+# ------------------
+# JAVA_HOME - location of a JDK home dir
+#
+# Optional ENV vars
+# -----------------
+# M2_HOME - location of maven2's installed home dir
+# MAVEN_OPTS - parameters passed to the Java VM when running Maven
+# e.g. to debug Maven itself, use
+# set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+# MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+# ----------------------------------------------------------------------------
+
+if [ -z "$MAVEN_SKIP_RC" ] ; then
+
+ if [ -f /etc/mavenrc ] ; then
+ . /etc/mavenrc
+ fi
+
+ if [ -f "$HOME/.mavenrc" ] ; then
+ . "$HOME/.mavenrc"
+ fi
+
+fi
+
+# OS specific support. $var _must_ be set to either true or false.
+cygwin=false;
+darwin=false;
+mingw=false
+case "`uname`" in
+ CYGWIN*) cygwin=true ;;
+ MINGW*) mingw=true;;
+ Darwin*) darwin=true
+ # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home
+ # See https://developer.apple.com/library/mac/qa/qa1170/_index.html
+ if [ -z "$JAVA_HOME" ]; then
+ if [ -x "/usr/libexec/java_home" ]; then
+ export JAVA_HOME="`/usr/libexec/java_home`"
+ else
+ export JAVA_HOME="/Library/Java/Home"
+ fi
+ fi
+ ;;
+esac
+
+if [ -z "$JAVA_HOME" ] ; then
+ if [ -r /etc/gentoo-release ] ; then
+ JAVA_HOME=`java-config --jre-home`
+ fi
+fi
+
+if [ -z "$M2_HOME" ] ; then
+ ## resolve links - $0 may be a link to maven's home
+ PRG="$0"
+
+ # need this for relative symlinks
+ while [ -h "$PRG" ] ; do
+ ls=`ls -ld "$PRG"`
+ link=`expr "$ls" : '.*-> \(.*\)$'`
+ if expr "$link" : '/.*' > /dev/null; then
+ PRG="$link"
+ else
+ PRG="`dirname "$PRG"`/$link"
+ fi
+ done
+
+ saveddir=`pwd`
+
+ M2_HOME=`dirname "$PRG"`/..
+
+ # make it fully qualified
+ M2_HOME=`cd "$M2_HOME" && pwd`
+
+ cd "$saveddir"
+ # echo Using m2 at $M2_HOME
+fi
+
+# For Cygwin, ensure paths are in UNIX format before anything is touched
+if $cygwin ; then
+ [ -n "$M2_HOME" ] &&
+ M2_HOME=`cygpath --unix "$M2_HOME"`
+ [ -n "$JAVA_HOME" ] &&
+ JAVA_HOME=`cygpath --unix "$JAVA_HOME"`
+ [ -n "$CLASSPATH" ] &&
+ CLASSPATH=`cygpath --path --unix "$CLASSPATH"`
+fi
+
+# For Mingw, ensure paths are in UNIX format before anything is touched
+if $mingw ; then
+ [ -n "$M2_HOME" ] &&
+ M2_HOME="`(cd "$M2_HOME"; pwd)`"
+ [ -n "$JAVA_HOME" ] &&
+ JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`"
+ # TODO classpath?
+fi
+
+if [ -z "$JAVA_HOME" ]; then
+ javaExecutable="`which javac`"
+ if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then
+ # readlink(1) is not available as standard on Solaris 10.
+ readLink=`which readlink`
+ if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then
+ if $darwin ; then
+ javaHome="`dirname \"$javaExecutable\"`"
+ javaExecutable="`cd \"$javaHome\" && pwd -P`/javac"
+ else
+ javaExecutable="`readlink -f \"$javaExecutable\"`"
+ fi
+ javaHome="`dirname \"$javaExecutable\"`"
+ javaHome=`expr "$javaHome" : '\(.*\)/bin'`
+ JAVA_HOME="$javaHome"
+ export JAVA_HOME
+ fi
+ fi
+fi
+
+if [ -z "$JAVACMD" ] ; then
+ if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD="$JAVA_HOME/jre/sh/java"
+ else
+ JAVACMD="$JAVA_HOME/bin/java"
+ fi
+ else
+ JAVACMD="`which java`"
+ fi
+fi
+
+if [ ! -x "$JAVACMD" ] ; then
+ echo "Error: JAVA_HOME is not defined correctly." >&2
+ echo " We cannot execute $JAVACMD" >&2
+ exit 1
+fi
+
+if [ -z "$JAVA_HOME" ] ; then
+ echo "Warning: JAVA_HOME environment variable is not set."
+fi
+
+CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher
+
+# traverses directory structure from process work directory to filesystem root
+# first directory with .mvn subdirectory is considered project base directory
+find_maven_basedir() {
+
+ if [ -z "$1" ]
+ then
+ echo "Path not specified to find_maven_basedir"
+ return 1
+ fi
+
+ basedir="$1"
+ wdir="$1"
+ while [ "$wdir" != '/' ] ; do
+ if [ -d "$wdir"/.mvn ] ; then
+ basedir=$wdir
+ break
+ fi
+ # workaround for JBEAP-8937 (on Solaris 10/Sparc)
+ if [ -d "${wdir}" ]; then
+ wdir=`cd "$wdir/.."; pwd`
+ fi
+ # end of workaround
+ done
+ echo "${basedir}"
+}
+
+# concatenates all lines of a file
+concat_lines() {
+ if [ -f "$1" ]; then
+ echo "$(tr -s '\n' ' ' < "$1")"
+ fi
+}
+
+BASE_DIR=`find_maven_basedir "$(pwd)"`
+if [ -z "$BASE_DIR" ]; then
+ exit 1;
+fi
+
+##########################################################################################
+# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+# This allows using the maven wrapper in projects that prohibit checking in binary data.
+##########################################################################################
+if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo "Found .mvn/wrapper/maven-wrapper.jar"
+ fi
+else
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..."
+ fi
+ jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.4.2/maven-wrapper-0.4.2.jar"
+ while IFS="=" read key value; do
+ case "$key" in (wrapperUrl) jarUrl="$value"; break ;;
+ esac
+ done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties"
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo "Downloading from: $jarUrl"
+ fi
+ wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar"
+
+ if command -v wget > /dev/null; then
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo "Found wget ... using wget"
+ fi
+ wget "$jarUrl" -O "$wrapperJarPath"
+ elif command -v curl > /dev/null; then
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo "Found curl ... using curl"
+ fi
+ curl -o "$wrapperJarPath" "$jarUrl"
+ else
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo "Falling back to using Java to download"
+ fi
+ javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java"
+ if [ -e "$javaClass" ]; then
+ if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo " - Compiling MavenWrapperDownloader.java ..."
+ fi
+ # Compiling the Java class
+ ("$JAVA_HOME/bin/javac" "$javaClass")
+ fi
+ if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
+ # Running the downloader
+ if [ "$MVNW_VERBOSE" = true ]; then
+ echo " - Running MavenWrapperDownloader.java ..."
+ fi
+ ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR")
+ fi
+ fi
+ fi
+fi
+##########################################################################################
+# End of extension
+##########################################################################################
+
+export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}
+if [ "$MVNW_VERBOSE" = true ]; then
+ echo $MAVEN_PROJECTBASEDIR
+fi
+MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS"
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin; then
+ [ -n "$M2_HOME" ] &&
+ M2_HOME=`cygpath --path --windows "$M2_HOME"`
+ [ -n "$JAVA_HOME" ] &&
+ JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"`
+ [ -n "$CLASSPATH" ] &&
+ CLASSPATH=`cygpath --path --windows "$CLASSPATH"`
+ [ -n "$MAVEN_PROJECTBASEDIR" ] &&
+ MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"`
+fi
+
+WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+exec "$JAVACMD" \
+ $MAVEN_OPTS \
+ -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
+ "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
+ ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"
diff --git a/spring-data-r2dbc/mvnw.cmd b/spring-data-r2dbc/mvnw.cmd
new file mode 100755
index 00000000..e5cfb0ae
--- /dev/null
+++ b/spring-data-r2dbc/mvnw.cmd
@@ -0,0 +1,161 @@
+@REM ----------------------------------------------------------------------------
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements. See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership. The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License. You may obtain a copy of the License at
+@REM
+@REM http://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied. See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+@REM ----------------------------------------------------------------------------
+
+@REM ----------------------------------------------------------------------------
+@REM Maven2 Start Up Batch script
+@REM
+@REM Required ENV vars:
+@REM JAVA_HOME - location of a JDK home dir
+@REM
+@REM Optional ENV vars
+@REM M2_HOME - location of maven2's installed home dir
+@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands
+@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a key stroke before ending
+@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven
+@REM e.g. to debug Maven itself, use
+@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+@REM ----------------------------------------------------------------------------
+
+@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on'
+@echo off
+@REM set title of command window
+title %0
+@REM enable echoing my setting MAVEN_BATCH_ECHO to 'on'
+@if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO%
+
+@REM set %HOME% to equivalent of $HOME
+if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%")
+
+@REM Execute a user defined script before this one
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre
+@REM check for pre script, once with legacy .bat ending and once with .cmd ending
+if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat"
+if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd"
+:skipRcPre
+
+@setlocal
+
+set ERROR_CODE=0
+
+@REM To isolate internal variables from possible post scripts, we use another setlocal
+@setlocal
+
+@REM ==== START VALIDATION ====
+if not "%JAVA_HOME%" == "" goto OkJHome
+
+echo.
+echo Error: JAVA_HOME not found in your environment. >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+:OkJHome
+if exist "%JAVA_HOME%\bin\java.exe" goto init
+
+echo.
+echo Error: JAVA_HOME is set to an invalid directory. >&2
+echo JAVA_HOME = "%JAVA_HOME%" >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+@REM ==== END VALIDATION ====
+
+:init
+
+@REM Find the project base dir, i.e. the directory that contains the folder ".mvn".
+@REM Fallback to current working directory if not found.
+
+set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR%
+IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir
+
+set EXEC_DIR=%CD%
+set WDIR=%EXEC_DIR%
+:findBaseDir
+IF EXIST "%WDIR%"\.mvn goto baseDirFound
+cd ..
+IF "%WDIR%"=="%CD%" goto baseDirNotFound
+set WDIR=%CD%
+goto findBaseDir
+
+:baseDirFound
+set MAVEN_PROJECTBASEDIR=%WDIR%
+cd "%EXEC_DIR%"
+goto endDetectBaseDir
+
+:baseDirNotFound
+set MAVEN_PROJECTBASEDIR=%EXEC_DIR%
+cd "%EXEC_DIR%"
+
+:endDetectBaseDir
+
+IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig
+
+@setlocal EnableExtensions EnableDelayedExpansion
+for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a
+@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS%
+
+:endReadAdditionalConfig
+
+SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe"
+set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar"
+set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.4.2/maven-wrapper-0.4.2.jar"
+FOR /F "tokens=1,2 delims==" %%A IN (%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties) DO (
+ IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B
+)
+
+@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+@REM This allows using the maven wrapper in projects that prohibit checking in binary data.
+if exist %WRAPPER_JAR% (
+ echo Found %WRAPPER_JAR%
+) else (
+ echo Couldn't find %WRAPPER_JAR%, downloading it ...
+ echo Downloading from: %DOWNLOAD_URL%
+ powershell -Command "(New-Object Net.WebClient).DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"
+ echo Finished downloading %WRAPPER_JAR%
+)
+@REM End of extension
+
+%MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %*
+if ERRORLEVEL 1 goto error
+goto end
+
+:error
+set ERROR_CODE=1
+
+:end
+@endlocal & set ERROR_CODE=%ERROR_CODE%
+
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost
+@REM check for post script, once with legacy .bat ending and once with .cmd ending
+if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat"
+if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd"
+:skipRcPost
+
+@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on'
+if "%MAVEN_BATCH_PAUSE%" == "on" pause
+
+if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE%
+
+exit /B %ERROR_CODE%
diff --git a/spring-data-r2dbc/pom.xml b/spring-data-r2dbc/pom.xml
new file mode 100644
index 00000000..50e5344f
--- /dev/null
+++ b/spring-data-r2dbc/pom.xml
@@ -0,0 +1,493 @@
+
+
+
+ 4.0.0
+
+ org.springframework.data
+ spring-data-r2dbc
+ 3.0.0-SNAPSHOT
+
+ Spring Data R2DBC
+ Spring Data module for R2DBC
+ https://projects.spring.io/spring-data-r2dbc
+
+
+ org.springframework.data.build
+ spring-data-parent
+ 3.0.0-SNAPSHOT
+
+
+
+
+ DATAR2DBC
+
+ 3.0.0-SNAPSHOT
+ 3.0.0-SNAPSHOT
+ ${springdata.jdbc}
+ spring.data.r2dbc
+ reuseReports
+
+ 0.1.4
+ 42.2.25
+ 8.0.21
+ 0.9.1.RELEASE
+ 7.1.2.jre8-preview
+ 2.5.4
+ Borca-RELEASE
+ 1.0.3
+ 4.1.73.Final
+
+
+ 2018
+
+
+
+ mpaluch
+ Mark Paluch
+ mpaluch(at)pivotal.io
+ Pivotal Software, Inc.
+ https://pivotal.io
+
+ Project Lead
+
+ +1
+
+
+ ogierke
+ Oliver Gierke
+ ogierke(at)pivotal.io
+ Pivotal Software, Inc.
+ https://pivotal.io
+
+ Project Lead
+
+ +1
+
+
+
+
+
+
+ io.r2dbc
+ r2dbc-bom
+ ${r2dbc-releasetrain.version}
+ pom
+ import
+
+
+ org.testcontainers
+ testcontainers-bom
+ ${testcontainers}
+ pom
+ import
+
+
+ io.netty
+ netty-bom
+ ${netty}
+ pom
+ import
+
+
+
+
+
+
+
+ ${project.groupId}
+ spring-data-commons
+ ${springdata.commons}
+
+
+
+ ${project.groupId}
+ spring-data-relational
+ ${springdata.relational}
+
+
+
+ org.springframework
+ spring-r2dbc
+
+
+
+ org.springframework
+ spring-tx
+
+
+
+ org.springframework
+ spring-context
+
+
+
+ org.springframework
+ spring-beans
+
+
+
+ org.springframework
+ spring-jdbc
+ true
+
+
+
+ org.springframework
+ spring-core
+
+
+
+ io.r2dbc
+ r2dbc-spi
+
+
+
+ io.projectreactor
+ reactor-core
+
+
+
+
+ org.jetbrains.kotlin
+ kotlin-stdlib
+ true
+
+
+
+ org.jetbrains.kotlin
+ kotlin-reflect
+ true
+
+
+
+ org.jetbrains.kotlinx
+ kotlinx-coroutines-core
+ true
+
+
+
+ org.jetbrains.kotlinx
+ kotlinx-coroutines-reactor
+ true
+
+
+
+ org.assertj
+ assertj-core
+ ${assertj}
+ test
+
+
+
+ io.projectreactor
+ reactor-test
+ test
+
+
+
+
+
+ org.postgresql
+ postgresql
+ ${postgresql.version}
+ test
+
+
+
+ mysql
+ mysql-connector-java
+ ${mysql.version}
+ test
+
+
+
+ org.mariadb.jdbc
+ mariadb-java-client
+ ${mariadb-jdbc.version}
+ test
+
+
+
+ com.microsoft.sqlserver
+ mssql-jdbc
+ ${mssql-jdbc.version}
+ test
+
+
+
+ com.oracle.database.jdbc
+ ojdbc11
+ 21.4.0.0.1
+ test
+
+
+
+
+
+ org.postgresql
+ r2dbc-postgresql
+ true
+
+
+
+ io.r2dbc
+ r2dbc-h2
+ test
+
+
+
+ io.r2dbc
+ r2dbc-mssql
+ test
+
+
+
+ org.mariadb
+ r2dbc-mariadb
+ test
+
+
+
+ io.r2dbc
+ r2dbc-spi-test
+ ${r2dbc-spi-test.version}
+ test
+
+
+
+
+
+ org.testcontainers
+ mysql
+ test
+
+
+ org.slf4j
+ jcl-over-slf4j
+
+
+
+
+
+ org.testcontainers
+ mariadb
+ test
+
+
+ org.slf4j
+ jcl-over-slf4j
+
+
+
+
+
+ org.testcontainers
+ oracle-xe
+ test
+
+
+
+ org.testcontainers
+ postgresql
+ test
+
+
+
+ de.schauderhaft.degraph
+ degraph-check
+ ${degraph-check.version}
+ test
+
+
+
+ io.mockk
+ mockk
+ ${mockk}
+ test
+
+
+
+ org.awaitility
+ awaitility
+ 4.0.3
+ test
+
+
+
+
+
+
+
+
+
+
+ org.jacoco
+ jacoco-maven-plugin
+ ${jacoco}
+
+ ${jacoco.destfile}
+
+
+
+ jacoco-initialize
+
+ prepare-agent
+
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-javadoc-plugin
+
+
+ https://docs.spring.io/spring/docs/${spring}/javadoc-api/
+
+
+ https://docs.spring.io/spring-data/commons/docs/current/api/
+
+ https://docs.oracle.com/javase/8/docs/api/
+ https://r2dbc.io/spec/0.8.0.RELEASE/api/
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-surefire-plugin
+
+
+ default-test
+
+
+ **/*Tests.java
+
+
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-assembly-plugin
+
+
+
+ org.asciidoctor
+ asciidoctor-maven-plugin
+
+ ${project.root}/src/main/asciidoc
+ index.adoc
+ book
+
+ ${project.version}
+ ${project.name}
+ ${project.version}
+ ${aspectj}
+ ${querydsl}
+ ${spring}
+ ${r2dbc-releasetrain.version}
+ ${reactive-streams.version}
+
+ ${releasetrain}
+ true
+ 3
+ true
+
+
+
+
+
+ org.codehaus.mojo
+ flatten-maven-plugin
+ 1.1.0
+
+
+ flatten
+ process-resources
+
+ flatten
+
+
+ true
+ oss
+
+ keep
+ keep
+ expand
+ remove
+
+
+
+
+ flatten-clean
+ clean
+
+ clean
+
+
+
+
+
+
+
+
+
+ no-jacoco
+
+
+
+ org.jacoco
+ jacoco-maven-plugin
+
+
+ jacoco-initialize
+ none
+
+
+
+
+
+
+
+
+ java11
+
+
+
+ com.oracle.database.r2dbc
+ oracle-r2dbc
+ 0.1.0
+ test
+
+
+
+
+
+
+
+
+ spring-libs-snapshot
+ https://repo.spring.io/libs-snapshot
+
+
+ oss-sonatype-snapshots
+ https://oss.sonatype.org/content/repositories/snapshots/
+
+ true
+
+
+
+
+
+
+ spring-plugins-release
+ https://repo.spring.io/plugins-release
+
+
+
+
diff --git a/spring-data-r2dbc/settings.xml b/spring-data-r2dbc/settings.xml
new file mode 100644
index 00000000..b3227cc1
--- /dev/null
+++ b/spring-data-r2dbc/settings.xml
@@ -0,0 +1,29 @@
+
+
+
+
+ spring-plugins-release
+ ${env.ARTIFACTORY_USR}
+ ${env.ARTIFACTORY_PSW}
+
+
+ spring-libs-snapshot
+ ${env.ARTIFACTORY_USR}
+ ${env.ARTIFACTORY_PSW}
+
+
+ spring-libs-milestone
+ ${env.ARTIFACTORY_USR}
+ ${env.ARTIFACTORY_PSW}
+
+
+ spring-libs-release
+ ${env.ARTIFACTORY_USR}
+ ${env.ARTIFACTORY_PSW}
+
+
+
+
\ No newline at end of file
diff --git a/spring-data-r2dbc/src/main/asciidoc/index.adoc b/spring-data-r2dbc/src/main/asciidoc/index.adoc
new file mode 100644
index 00000000..f48f1687
--- /dev/null
+++ b/spring-data-r2dbc/src/main/asciidoc/index.adoc
@@ -0,0 +1,53 @@
+= Spring Data R2DBC - Reference Documentation
+ Mark Paluch, Jay Bryant, Stephen Cohen
+:revnumber: {version}
+:revdate: {localdate}
+ifdef::backend-epub3[:front-cover-image: image:epub-cover.png[Front Cover,1050,1600]]
+:spring-data-commons-docs: ../../../../spring-data-commons/src/main/asciidoc
+:spring-data-r2dbc-javadoc: https://docs.spring.io/spring-data/r2dbc/docs/{version}/api
+:spring-framework-ref: https://docs.spring.io/spring/docs/{springVersion}/reference/html
+:reactiveStreamsJavadoc: https://www.reactive-streams.org/reactive-streams-{reactiveStreamsVersion}-javadoc
+:example-root: ../../../src/test/java/org/springframework/data/r2dbc/documentation
+:tabsize: 2
+
+(C) 2018-2022 The original authors.
+
+NOTE: Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.
+
+toc::[]
+
+// The blank line before each include prevents content from running together in a bad way
+// (because an included bit does not have its own blank lines).
+
+include::preface.adoc[]
+
+include::new-features.adoc[leveloffset=+1]
+
+include::{spring-data-commons-docs}/dependencies.adoc[leveloffset=+1]
+
+include::{spring-data-commons-docs}/repositories.adoc[leveloffset=+1]
+
+[[reference]]
+= Reference Documentation
+
+include::reference/introduction.adoc[leveloffset=+1]
+
+include::reference/r2dbc.adoc[leveloffset=+1]
+
+include::reference/r2dbc-repositories.adoc[leveloffset=+1]
+
+include::{spring-data-commons-docs}/auditing.adoc[leveloffset=+1]
+
+include::reference/r2dbc-auditing.adoc[leveloffset=+1]
+
+include::reference/mapping.adoc[leveloffset=+1]
+
+include::reference/kotlin.adoc[leveloffset=+1]
+
+[[appendix]]
+= Appendix
+
+:numbered!:
+include::{spring-data-commons-docs}/repository-query-keywords-reference.adoc[leveloffset=+1]
+include::{spring-data-commons-docs}/repository-query-return-types-reference.adoc[leveloffset=+1]
+include::reference/r2dbc-upgrading.adoc[leveloffset=+1]
diff --git a/spring-data-r2dbc/src/main/asciidoc/new-features.adoc b/spring-data-r2dbc/src/main/asciidoc/new-features.adoc
new file mode 100644
index 00000000..5665a848
--- /dev/null
+++ b/spring-data-r2dbc/src/main/asciidoc/new-features.adoc
@@ -0,0 +1,45 @@
+[[new-features]]
+= New & Noteworthy
+
+[[new-features.1-3-0]]
+== What's New in Spring Data R2DBC 1.3.0
+
+* Introduce <>.
+
+[[new-features.1-2-0]]
+== What's New in Spring Data R2DBC 1.2.0
+
+* Deprecate Spring Data R2DBC `DatabaseClient` and move off deprecated API in favor of Spring R2DBC.
+Consult the <> for further details.
+* Support for <>.
+* <> through `@EnableR2dbcAuditing`.
+* Support for `@Value` in persistence constructors.
+* Support for Oracle's R2DBC driver.
+
+[[new-features.1-1-0]]
+== What's New in Spring Data R2DBC 1.1.0
+
+* Introduction of `R2dbcEntityTemplate` for entity-oriented operations.
+* <>.
+* Support interface projections with `DatabaseClient.as(…)`.
+* <>.
+
+[[new-features.1-0-0]]
+== What's New in Spring Data R2DBC 1.0.0
+
+* Upgrade to R2DBC 0.8.0.RELEASE.
+* `@Modifying` annotation for query methods to consume affected row count.
+* Repository `save(…)` with an associated ID completes with `TransientDataAccessException` if the row does not exist in the database.
+* Added `SingleConnectionConnectionFactory` for testing using connection singletons.
+* Support for {spring-framework-ref}/core.html#expressions[SpEL expressions] in `@Query`.
+* `ConnectionFactory` routing through `AbstractRoutingConnectionFactory`.
+* Utilities for schema initialization through `ResourceDatabasePopulator` and `ScriptUtils`.
+* Propagation and reset of Auto-Commit and Isolation Level control through `TransactionDefinition`.
+* Support for Entity-level converters.
+* Kotlin extensions for reified generics and <>.
+* Add pluggable mechanism to register dialects.
+* Support for named parameters.
+* Initial R2DBC support through `DatabaseClient`.
+* Initial Transaction support through `TransactionalDatabaseClient`.
+* Initial R2DBC Repository Support through `R2dbcRepository`.
+* Initial Dialect support for Postgres and Microsoft SQL Server.
diff --git a/spring-data-r2dbc/src/main/asciidoc/preface.adoc b/spring-data-r2dbc/src/main/asciidoc/preface.adoc
new file mode 100644
index 00000000..126d4bae
--- /dev/null
+++ b/spring-data-r2dbc/src/main/asciidoc/preface.adoc
@@ -0,0 +1,122 @@
+[[preface]]
+= Preface
+
+The Spring Data R2DBC project applies core Spring concepts to the development of solutions that use the https://r2dbc.io[R2DBC] drivers for relational databases.
+We provide a `DatabaseClient` as a high-level abstraction for storing and querying rows.
+
+This document is the reference guide for Spring Data - R2DBC Support.
+It explains R2DBC module concepts and semantics.
+
+This section provides some basic introduction to Spring and databases.
+[[get-started:first-steps:spring]]
+== Learning Spring
+
+Spring Data uses Spring framework's {spring-framework-ref}/core.html[core] functionality, including:
+
+* {spring-framework-ref}/core.html#beans[IoC] container
+* {spring-framework-ref}/core.html#validation[type conversion system]
+* {spring-framework-ref}/core.html#expressions[expression language]
+* {spring-framework-ref}/integration.html#jmx[JMX integration]
+* {spring-framework-ref}/data-access.html#dao-exceptions[DAO exception hierarchy].
+
+While you need not know the Spring APIs, understanding the concepts behind them is important.
+At a minimum, the idea behind Inversion of Control (IoC) should be familiar, and you should be familiar with whatever IoC container you choose to use.
+
+You can use the core functionality of the R2DBC support directly, with no need to invoke the IoC services of the Spring Container.
+This is much like `JdbcTemplate`, which can be used "`standalone`" without any other services of the Spring container.
+To use all the features of Spring Data R2DBC, such as the repository support, you need to configure some parts of the library to use Spring.
+
+To learn more about Spring, refer to the comprehensive documentation that explains the Spring Framework in detail.
+There are a lot of articles, blog entries, and books on the subject.
+See the Spring framework https://spring.io/docs[home page] for more information.
+
+[[get-started:first-steps:what]]
+== What is R2DBC?
+
+https://r2dbc.io[R2DBC] is the acronym for Reactive Relational Database Connectivity.
+R2DBC is an API specification initiative that declares a reactive API to be implemented by driver vendors to access their relational databases.
+
+Part of the answer as to why R2DBC was created is the need for a non-blocking application stack to handle concurrency with a small number of threads and scale with fewer hardware resources.
+This need cannot be satisfied by reusing standardized relational database access APIs -- namely JDBC –- as JDBC is a fully blocking API.
+Attempts to compensate for blocking behavior with a `ThreadPool` are of limited use.
+
+The other part of the answer is that most applications use a relational database to store their data.
+While several NoSQL database vendors provide reactive database clients for their databases, migration to NoSQL is not an option for most projects.
+This was the motivation for a new common API to serve as a foundation for any non-blocking database driver.
+While the open source ecosystem hosts various non-blocking relational database driver implementations, each client comes with a vendor-specific API, so a generic layer on top of these libraries is not possible.
+
+[[get-started:first-steps:reactive]]
+== What is Reactive?
+
+The term, "`reactive`", refers to programming models that are built around reacting to change, availability, and processability -— network components reacting to I/O events, UI controllers reacting to mouse events, resources being made available, and others.
+In that sense, non-blocking is reactive, because, instead of being blocked, we are now in the mode of reacting to notifications as operations complete or data becomes available.
+
+There is also another important mechanism that we on the Spring team associate with reactive, and that is non-blocking back pressure.
+In synchronous, imperative code, blocking calls serve as a natural form of back pressure that forces the caller to wait.
+In non-blocking code, it becomes essential to control the rate of events so that a fast producer does not overwhelm its destination.
+
+https://github.com/reactive-streams/reactive-streams-jvm/blob/v{reactiveStreamsVersion}/README.md#specification[Reactive Streams is a small spec] (also https://docs.oracle.com/javase/9/docs/api/java/util/concurrent/Flow.html[adopted in Java 9]) that defines the interaction between asynchronous components with back pressure.
+For example, a data repository (acting as a {reactiveStreamsJavadoc}/org/reactivestreams/Publisher.html[`Publisher`]) can produce data that an HTTP server (acting as a {reactiveStreamsJavadoc}/org/reactivestreams/Subscriber.html`[`Subscriber`]) can then write to the response.
+The main purpose of Reactive Streams is to let the subscriber control how quickly or how slowly the publisher produces data.
+
+[[get-started:first-steps:reactive-api]]
+== Reactive API
+
+Reactive Streams plays an important role for interoperability. It is of interest to libraries and infrastructure components but less useful as an application API, because it is too low-level.
+Applications need a higher-level and richer, functional API to compose async logic —- similar to the Java 8 Stream API but not only for tables.
+This is the role that reactive libraries play.
+
+https://github.com/reactor/reactor[Project Reactor] is the reactive library of choice for Spring Data R2DBC.
+It provides the https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html[`Mono`] and https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Flux.html[`Flux`] API types to work on data sequences of `0..1` (`Mono`) and `0..N` (`Flux`) through a rich set of operators aligned with the ReactiveX vocabulary of operators.
+Reactor is a Reactive Streams library, and, therefore, all of its operators support non-blocking back pressure.
+Reactor has a strong focus on server-side Java. It is developed in close collaboration with Spring.
+
+Spring Data R2DBC requires Project Reactor as a core dependency, but it is interoperable with other reactive libraries through the Reactive Streams specification.
+As a general rule, a Spring Data R2DBC repository accepts a plain `Publisher` as input, adapts it to a Reactor type internally, uses that, and returns either a `Mono` or a `Flux` as output.
+So, you can pass any `Publisher` as input and apply operations on the output, but you need to adapt the output for use with another reactive library.
+Whenever feasible, Spring Data adapts transparently to the use of RxJava or another reactive library.
+
+[[requirements]]
+== Requirements
+
+The Spring Data R2DBC 1.x binaries require:
+
+* JDK level 8.0 and above
+* https://spring.io/docs[Spring Framework] {springVersion} and above
+* https://r2dbc.io[R2DBC] {r2dbcVersion} and above
+
+[[get-started:help]]
+== Additional Help Resources
+
+Learning a new framework is not always straightforward.
+In this section, we try to provide what we think is an easy-to-follow guide for starting with the Spring Data R2DBC module.
+However, if you encounter issues or you need advice, use one of the following links:
+
+[[get-started:help:community]]
+Community Forum :: Spring Data on https://stackoverflow.com/questions/tagged/spring-data[Stack Overflow] is a tag for all Spring Data (not just R2DBC) users to share information and help each other.
+Note that registration is needed only for posting.
+
+[[get-started:help:professional]]
+Professional Support :: Professional, from-the-source support, with guaranteed response time, is available from https://pivotal.io/[Pivotal Sofware, Inc.], the company behind Spring Data and Spring.
+
+[[get-started:up-to-date]]
+== Following Development
+
+* For information on the Spring Data R2DBC source code repository, nightly builds, and snapshot artifacts, see the Spring Data R2DBC https://projects.spring.io/spring-data-r2dbc/[home page].
+
+* You can help make Spring Data best serve the needs of the Spring community by interacting with developers through the community on https://stackoverflow.com/questions/tagged/spring-data[Stack Overflow].
+
+* If you encounter a bug or want to suggest an improvement, please create a ticket on the Spring Data R2DBC https://github.com/spring-projects/spring-data-r2dbc/issues[issue tracker].
+
+* To stay up to date with the latest news and announcements in the Spring ecosystem, subscribe to the Spring Community https://spring.io[Portal].
+
+* You can also follow the Spring https://spring.io/blog[blog] or the Spring Data project team on Twitter (https://twitter.com/SpringData[SpringData]).
+
+[[project-metadata]]
+== Project Metadata
+
+* Version control: https://github.com/spring-projects/spring-data-r2dbc
+* Bugtracker: https://github.com/spring-projects/spring-data-r2dbc/issues
+* Release repository: https://repo.spring.io/libs-release
+* Milestone repository: https://repo.spring.io/libs-milestone
+* Snapshot repository: https://repo.spring.io/libs-snapshot
diff --git a/spring-data-r2dbc/src/main/asciidoc/reference/introduction.adoc b/spring-data-r2dbc/src/main/asciidoc/reference/introduction.adoc
new file mode 100644
index 00000000..597beb24
--- /dev/null
+++ b/spring-data-r2dbc/src/main/asciidoc/reference/introduction.adoc
@@ -0,0 +1,10 @@
+[[introduction]]
+= Introduction
+
+== Document Structure
+
+This part of the reference documentation explains the core functionality offered by Spring Data R2DBC.
+
+"`<>`" introduces the R2DBC module feature set.
+
+"`<>`" introduces the repository support for R2DBC.
diff --git a/spring-data-r2dbc/src/main/asciidoc/reference/kotlin.adoc b/spring-data-r2dbc/src/main/asciidoc/reference/kotlin.adoc
new file mode 100644
index 00000000..c64b3b4d
--- /dev/null
+++ b/spring-data-r2dbc/src/main/asciidoc/reference/kotlin.adoc
@@ -0,0 +1,28 @@
+include::../{spring-data-commons-docs}/kotlin.adoc[]
+
+include::../{spring-data-commons-docs}/kotlin-extensions.adoc[leveloffset=+1]
+
+To retrieve a list of `SWCharacter` objects in Java, you would normally write the following:
+
+[source,java]
+----
+Flux characters = client.select().from(SWCharacter.class).fetch().all();
+----
+
+With Kotlin and the Spring Data extensions, you can instead write the following:
+
+[source,kotlin]
+----
+val characters = client.select().from().fetch().all()
+// or (both are equivalent)
+val characters : Flux = client.select().from().fetch().all()
+----
+
+As in Java, `characters` in Kotlin is strongly typed, but Kotlin's clever type inference allows for shorter syntax.
+
+Spring Data R2DBC provides the following extensions:
+
+* Reified generics support for `DatabaseClient` and `Criteria`.
+* <> extensions for `DatabaseClient`.
+
+include::../{spring-data-commons-docs}/kotlin-coroutines.adoc[leveloffset=+1]
diff --git a/spring-data-r2dbc/src/main/asciidoc/reference/mapping.adoc b/spring-data-r2dbc/src/main/asciidoc/reference/mapping.adoc
new file mode 100644
index 00000000..a9f17e6d
--- /dev/null
+++ b/spring-data-r2dbc/src/main/asciidoc/reference/mapping.adoc
@@ -0,0 +1,324 @@
+[[mapping]]
+= Mapping
+
+Rich mapping support is provided by the `MappingR2dbcConverter`. `MappingR2dbcConverter` has a rich metadata model that allows mapping domain objects to a data row.
+The mapping metadata model is populated by using annotations on your domain objects.
+However, the infrastructure is not limited to using annotations as the only source of metadata information.
+The `MappingR2dbcConverter` also lets you map objects to rows without providing any additional metadata, by following a set of conventions.
+
+This section describes the features of the `MappingR2dbcConverter`, including how to use conventions for mapping objects to rows and how to override those conventions with annotation-based mapping metadata.
+
+include::../{spring-data-commons-docs}/object-mapping.adoc[leveloffset=+1]
+
+[[mapping.conventions]]
+== Convention-based Mapping
+
+`MappingR2dbcConverter` has a few conventions for mapping objects to rows when no additional mapping metadata is provided.
+The conventions are:
+
+* The short Java class name is mapped to the table name in the following manner.
+The `com.bigbank.SavingsAccount` class maps to the `SAVINGS_ACCOUNT` table name.
+The same name mapping is applied for mapping fields to column names.
+For example, the `firstName` field maps to the `FIRST_NAME` column.
+You can control this mapping by providing a custom `NamingStrategy`. See <> for more detail.
+Table and column names that are derived from property or class names are used in SQL statements without quotes by default.
+You can control this behavior by setting `R2dbcMappingContext.setForceQuote(true)`.
+
+* Nested objects are not supported.
+
+* The converter uses any Spring Converters registered with it to override the default mapping of object properties to row columns and values.
+
+* The fields of an object are used to convert to and from columns in the row.
+Public `JavaBean` properties are not used.
+
+* If you have a single non-zero-argument constructor whose constructor argument names match top-level column names of the row, that constructor is used.
+Otherwise, the zero-argument constructor is used.
+If there is more than one non-zero-argument constructor, an exception is thrown.
+
+[[mapping.configuration]]
+== Mapping Configuration
+
+By default (unless explicitly configured) an instance of `MappingR2dbcConverter` is created when you create a `DatabaseClient`.
+You can create your own instance of the `MappingR2dbcConverter`.
+By creating your own instance, you can register Spring converters to map specific classes to and from the database.
+
+You can configure the `MappingR2dbcConverter` as well as `DatabaseClient` and `ConnectionFactory` by using Java-based metadata. The following example uses Spring's Java-based configuration:
+
+If you set `setForceQuote` of the `R2dbcMappingContext to` true, table and column names derived from classes and properties are used with database specific quotes.
+This means that it is OK to use reserved SQL words (such as order) in these names.
+You can do so by overriding `r2dbcMappingContext(Optional)` of `AbstractR2dbcConfiguration`.
+Spring Data converts the letter casing of such a name to that form which is also used by the configured database when no quoting is used.
+Therefore, you can use unquoted names when creating tables, as long as you do not use keywords or special characters in your names.
+For databases that adhere to the SQL standard, this means that names are converted to upper case.
+The quoting character and the way names get capitalized is controlled by the used `Dialect`.
+See <> for how to configure custom dialects.
+
+.@Configuration class to configure R2DBC mapping support
+====
+[source,java]
+----
+@Configuration
+public class MyAppConfig extends AbstractR2dbcConfiguration {
+
+ public ConnectionFactory connectionFactory() {
+ return ConnectionFactories.get("r2dbc:…");
+ }
+
+ // the following are optional
+
+ @Override
+ protected List