|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Data MongoDB 4.4.0！ |
Tailable 游标
默认情况下，当客户端用尽游标提供的所有结果时，MongoDB 会自动关闭游标。 在耗尽时关闭游标会将流转换为有限流。对于上限集合， 你可以使用在客户端之后保持打开状态的 Tailable Cursor 使用所有最初返回的数据。
可以使用MongoOperations.createCollection.为此，请提供所需的CollectionOptions.empty().capped()…. |
Tailable 游标可以与命令式和反应式 MongoDB API 一起使用。强烈建议使用 reactive 变体，因为它的资源密集度较低。但是，如果您无法使用响应式 API，您仍然可以使用消息收发 这个概念在 Spring 生态系统中已经很普遍。
Tailable 游标MessageListener
使用 Sync Driver 侦听上限集合会创建一个长时间运行的阻塞任务，该任务需要委托给
一个单独的组件。在这种情况下，我们需要首先创建一个MessageListenerContainer，这将是主入口点
用于运行特定的SubscriptionRequest.Spring Data MongoDB 已经附带了一个默认实现
作MongoTemplate并且能够创建和运行Task实例的TailableCursorRequest.
以下示例演示如何将 tailable 游标与MessageListener实例：
MessageListener实例MessageListenerContainer container = new DefaultMessageListenerContainer(template);
container.start(); (1)
MessageListener<Document, User> listener = System.out::println; (2)
TailableCursorRequest request = TailableCursorRequest.builder()
.collection("orders") (3)
.filter(query(where("value").lt(100))) (4)
.publishTo(listener) (5)
.build();
container.register(request, User.class); (6)
// ...
container.stop(); (7)| 1 | 启动容器初始化资源并启动Task已注册的实例SubscriptionRequest实例。启动后添加的请求将立即运行。 |
| 2 | 定义在Message已收到。这Message#getBody()将转换为请求的域类型。用Document接收 Raw 结果而不进行转换。 |
| 3 | 设置要侦听的集合。 |
| 4 | 为要接收的文档提供可选的筛选器。 |
| 5 | 设置消息侦听器以发布传入Messages 到。 |
| 6 | 注册请求。返回的Subscription可用于检查当前Taskstate 并取消它以释放资源。 |
| 7 | 一旦您确定不再需要容器，请不要忘记停止容器。这样做会停止所有运行Task实例。 |
反应式 Tailable 游标
使用带有反应式数据类型的 tailable 游标可以构造无限流。tailable 游标保持打开状态，直到它在外部关闭。当新文档到达上限集合时，它会发出数据。
如果查询未返回匹配项，或者游标在集合的“末尾”返回文档，然后应用程序删除该文档，则可尾游标可能会失效或无效。以下示例演示如何创建和使用无限流查询：
Flux<Person> stream = template.tail(query(where("name").is("Joe")), Person.class);
Disposable subscription = stream.doOnNext(person -> System.out.println(person)).subscribe();
// …
// Later: Dispose the subscription to close the stream
subscription.dispose();Spring Data MongoDB Reactive 存储库通过使用 Comments 查询方法来支持无限流@Tailable.这适用于返回Flux和其他能够发出多个元素的响应式类型，如下例所示：
public interface PersonRepository extends ReactiveMongoRepository<Person, String> {
@Tailable
Flux<Person> findByFirstname(String firstname);
}
Flux<Person> stream = repository.findByFirstname("Joe");
Disposable subscription = stream.doOnNext(System.out::println).subscribe();
// …
// Later: Dispose the subscription to close the stream
subscription.dispose();