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

Tailable 游标

默认情况下，当客户端用尽游标提供的所有结果时，MongoDB 会自动关闭游标。 在耗尽时关闭游标会将流转换为有限流。对于上限集合， 你可以使用在客户端之后保持打开状态的 Tailable Cursor 使用所有最初返回的数据。spring-doc.cn

可以使用 创建上限收藏集。为此，请提供所需的 .MongoOperations.createCollectionCollectionOptions.empty().capped()…​

Tailable 游标可以与命令式和反应式 MongoDB API 一起使用。强烈建议使用 reactive 变体，因为它的资源密集度较低。但是，如果您无法使用响应式 API，您仍然可以使用消息收发 这个概念在 Spring 生态系统中已经很普遍。spring-doc.cn

Tailable 游标MessageListener

使用 Sync Driver 侦听上限集合会创建一个长时间运行的阻塞任务，该任务需要委托给 一个单独的组件。在这种情况下，我们需要首先创建一个 ，这将是主入口点 用于运行特定的 .Spring Data MongoDB 已经附带了一个默认实现 在 上运行，并且能够创建和运行 .MessageListenerContainerSubscriptionRequestMongoTemplateTaskTailableCursorRequestspring-doc.cn

以下示例演示如何将 tailable 游标与实例一起使用：MessageListenerspring-doc.cn

示例 1.带实例的 Tailable CursorsMessageListener
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 启动容器将初始化资源并启动已注册实例的实例。启动后添加的请求将立即运行。TaskSubscriptionRequest
2 定义收到 a 时调用的侦听器。将转换为请求的域类型。用于接收不进行转换的原始结果。MessageMessage#getBody()Document
3 设置要侦听的集合。
4 为要接收的文档提供可选的筛选器。
5 设置要将传入 s 发布到的消息侦听器。Message
6 注册请求。返回的可用于检查当前状态并取消它以释放资源。SubscriptionTask
7 一旦您确定不再需要容器，请不要忘记停止容器。这样做会停止容器内所有正在运行的实例。Task

反应式 Tailable 游标

使用带有反应式数据类型的 tailable 游标可以构造无限流。tailable 游标保持打开状态，直到它在外部关闭。当新文档到达上限集合时，它会发出数据。spring-doc.cn

如果查询未返回匹配项，或者游标在集合的“末尾”返回文档，然后应用程序删除该文档，则可尾游标可能会失效或无效。以下示例演示如何创建和使用无限流查询：spring-doc.cn

示例 2.使用 ReactiveMongoOperations 的无限流查询
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 存储库通过使用 .这适用于返回的方法和其他能够发出多个元素的反应式类型，如下例所示：@TailableFluxspring-doc.cn

例 3.使用 ReactiveMongoRepository 的无限流查询
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();