此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Data Relational 3.4.0！spring-doc.cn

R2DBC 存储库

本章指出了 R2DBC 的存储库支持的特殊性。这建立在使用 Spring Data Repositories 中解释的核心存储库支持之上。在阅读本章之前，您应该对其中解释的基本概念有很好的理解。spring-doc.cn

用法

要访问存储在关系数据库中的域实体，您可以使用我们复杂的存储库支持，这大大简化了实施。为此，请为您的仓库创建一个界面。请考虑以下类：Personspring-doc.cn

示例 Person 实体

public class Person {

  @Id
  private Long id;
  private String firstname;
  private String lastname;

  // … getters and setters omitted
}

以下示例显示了上述类的存储库接口：Personspring-doc.cn

用于持久保存 Person 实体的基本存储库界面

public interface PersonRepository extends ReactiveCrudRepository<Person, Long> {

  // additional custom query methods go here
}

要配置 R2DBC 存储库，您可以使用注释。如果未配置基础包，则基础架构将扫描带注释的配置类的包。以下示例说明如何对存储库使用 Java 配置：@EnableR2dbcRepositoriesspring-doc.cn

存储库的 Java 配置

@Configuration
@EnableR2dbcRepositories
class ApplicationConfig extends AbstractR2dbcConfiguration {

  @Override
  public ConnectionFactory connectionFactory() {
    return …
  }
}

由于我们的域存储库扩展了，因此它为您提供了反应式 CRUD 操作来访问实体。在之上，还有，它添加了类似于的其他排序功能。使用存储库实例只是将其注入客户端的依赖项问题。因此，您可以使用以下代码检索所有对象：ReactiveCrudRepositoryReactiveCrudRepositoryReactiveSortingRepositoryPagingAndSortingRepositoryPersonspring-doc.cn

对 Person 实体的分页访问

@ExtendWith(SpringExtension.class)
@ContextConfiguration
class PersonRepositoryTests {

  @Autowired
  PersonRepository repository;

  @Test
  void readsAllEntitiesCorrectly() {

    repository.findAll()
      .as(StepVerifier::create)
      .expectNextCount(1)
      .verifyComplete();
  }

  @Test
  void readsEntitiesByNameCorrectly() {

    repository.findByFirstname("Hello World")
      .as(StepVerifier::create)
      .expectNextCount(1)
      .verifyComplete();
  }
}

前面的示例使用 Spring 的单元测试支持创建应用程序上下文，该上下文对测试用例执行基于 Comments 的依赖项注入。在测试方法中，我们使用存储库来查询数据库。我们用作测试辅助工具，以根据结果验证我们的期望。StepVerifierspring-doc.cn

结果映射

返回 Interface 或 DTO 投影的查询方法由实际查询生成的结果提供支持。接口投影通常依赖于首先将结果映射到域类型上，以考虑潜在的类型映射，而实际的投影代理使用可能部分具体化的实体来公开投影数据。@Columnspring-doc.cn

DTO 投影的结果映射取决于实际的查询类型。派生查询使用域类型来映射结果， Spring Data 仅从域类型上可用的属性创建 DTO 实例。不支持在 DTO 中声明在域类型上不可用的属性。spring-doc.cn

基于字符串的查询使用不同的方法，因为实际查询（特别是字段投影和结果类型声明）非常接近。与使用映射查询结果注释的查询方法一起使用的 DTO 投影直接映射到 DTO 类型中。不考虑域类型的字段映射。直接使用 DTO 类型，您的查询方法可以从不限于域模型的更动态的投影中受益。@Queryspring-doc.cn

使用多个数据库

当使用多个可能不同的数据库时，您的应用程序将需要不同的配置方法。提供的 support 类假定 single 派生自。话虽如此，您需要自己定义一些 bean 来配置 Spring Data R2DBC 以使用多个数据库。AbstractR2dbcConfigurationConnectionFactoryDialectspring-doc.cn

R2DBC 存储库需要实现存储库。不使用 deploy 来扫描仓库的简单配置如下所示：R2dbcEntityOperationsAbstractR2dbcConfigurationspring-doc.cn

@Configuration
@EnableR2dbcRepositories(basePackages = "com.acme.mysql", entityOperationsRef = "mysqlR2dbcEntityOperations")
static class MySQLConfiguration {

    @Bean
    @Qualifier("mysql")
    public ConnectionFactory mysqlConnectionFactory() {
        return …
    }

    @Bean
    public R2dbcEntityOperations mysqlR2dbcEntityOperations(@Qualifier("mysql") ConnectionFactory connectionFactory) {

        DatabaseClient databaseClient = DatabaseClient.create(connectionFactory);

        return new R2dbcEntityTemplate(databaseClient, MySqlDialect.INSTANCE);
    }
}

请注意，允许通过或进行配置。在连接到同一类型的多个数据库时，使用各种 bean 非常有用。当使用方言不同的数据库系统时，请使用（entityOperationsRef = ...）' 取而代之。@EnableR2dbcRepositoriesdatabaseClientRefentityOperationsRefDatabaseClient@EnableR2dbcRepositoriesspring-doc.cn