跳到主要内容
版本:6.1.1

响应式 Couchbase 仓库

Doubao 中英对照 Reactive Couchbase repository

介绍​

本章介绍 Couchbase 的响应式仓库支持。它建立在Couchbase 仓库一节所讲解的核心仓库支持之上。因此,请务必先充分理解其中讲解的基本概念。

响应式组合库​

Couchbase Java SDK 3.x 已从 RxJava 迁移到 Reactor,因此它能与响应式 Spring 生态系统很好地融合。

响应式 Couchbase 仓库提供 Project Reactor 包装类型,只需扩展以下某个特定于库的仓库接口即可使用:

  • ReactiveCrudRepository

  • ReactiveSortingRepository

用法​

让我们先创建一个简单的实体:

示例 1. Person 实体示例

public class Person {

@Id
private String id;
private String firstname;
private String lastname;
private Address address;

// … getters and setters omitted
}

一个对应的仓库实现可能如下所示:

示例 2. 用于持久化 Person 实体的基本仓库接口

public interface ReactivePersonRepository extends ReactiveSortingRepository<Person, Long> {

Flux<Person> findByFirstname(String firstname);

Flux<Person> findByFirstname(Publisher<String> firstname);

Flux<Person> findByFirstnameOrderByLastname(String firstname, Pageable pageable);

Mono<Person> findByFirstnameAndLastname(String firstname, String lastname);
}

对于 Java 配置,请使用 @EnableReactiveCouchbaseRepositories 注解。该注解带有与命名空间元素完全相同的属性。如果未配置基础包,基础设施将扫描被注解的配置类所在的包。

另请注意,如果您在 Spring Boot 环境中使用它,很可能可以省略该注解,因为它已为您自动配置。

示例 3. 仓库的 Java 配置

@Configuration
@EnableReactiveCouchbaseRepositories
class ApplicationConfig extends AbstractCouchbaseConfiguration {
// ... (see configuration for details)
}

由于我们的领域仓库扩展了 ReactiveSortingRepository,它既为您提供 CRUD 操作,也提供按排序方式访问实体的方法。使用仓库实例只需将其依赖注入到客户端即可。

示例 4. 对 Person 实体的排序访问

public class PersonRepositoryTests {

@Autowired
ReactivePersonRepository repository;

@Test
public void sortsElementsCorrectly() {
Flux<Person> persons = repository.findAll(Sort.by(new Order(ASC, "lastname")));
assertNotNull(perons);
}
}

仓库与查询​

Spring Data 的响应式 Couchbase 已具备完整的查询支持,该支持已在阻塞式的仓库与查询一节中提供。