此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Integration 6.3.1Spring中文文档

此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Integration 6.3.1Spring中文文档

版本 2.1 引入了对 MongoDB 的支持:“高性能、开源、面向文档的数据库”。Spring中文文档

您需要将此依赖项包含在项目中:Spring中文文档

<dependency>
    <groupId>org.springframework.integration</groupId>
    <artifactId>spring-integration-mongodb</artifactId>
    <version>6.3.2-SNAPSHOT</version>
</dependency>
compile "org.springframework.integration:spring-integration-mongodb:6.3.2-SNAPSHOT"

要下载、安装和运行 MongoDB,请参阅 MongoDB 文档Spring中文文档

连接到 MongoDb

阻塞还是被动?

从版本 5.3 开始,Spring Integration 提供对响应式 MongoDB 驱动程序的支持,以便在访问 MongoDB 时启用非阻塞 I/O。 要启用响应式支持,请将 MongoDB 响应式流驱动程序添加到您的依赖项:Spring中文文档

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-reactivestreams</artifactId>
</dependency>
compile "org.mongodb:mongodb-driver-reactivestreams"

对于常规同步客户端,您需要将其各自的驱动程序添加到依赖项中:Spring中文文档

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-sync</artifactId>
</dependency>
compile "org.mongodb:mongodb-driver-sync"

它们都在框架中,以便更好地支持最终用户选择。optionalSpring中文文档

要开始与MongoDB交互,首先需要连接到它。 Spring Integration 建立在另一个 Spring 项目 Spring Data MongoDB 提供的支持之上。 它提供了名为 和 的工厂类,这些类简化了与 MongoDB 客户端 API 的集成。MongoDatabaseFactoryReactiveMongoDatabaseFactorySpring中文文档

Spring Data 默认提供阻塞 MongoDB 驱动程序,但您可以通过包含上述依赖项来选择被动使用。

MongoDatabaseFactory

要连接到 MongoDB,您可以使用接口的实现。MongoDatabaseFactorySpring中文文档

以下示例演示如何使用:SimpleMongoClientDatabaseFactorySpring中文文档

MongoDatabaseFactory mongoDbFactory =
        new SimpleMongoClientDatabaseFactory(com.mongodb.client.MongoClients.create(), "test");
<bean id="mongoDbFactory" class="o.s.data.mongodb.core.SimpleMongoClientDatabaseFactory">
    <constructor-arg>
        <bean class="com.mongodb.client.MongoClients" factory-method="create"/>
    </constructor-arg>
    <constructor-arg value="test"/>
</bean>

SimpleMongoClientDatabaseFactory采用两个参数:一个实例和一个指定数据库名称的参数。 如果需要配置属性(如 、 和其他属性),可以使用基础类提供的构造函数之一来传递这些属性。 有关如何配置MongoDB的更多信息,请参阅Spring-Data-MongoDB参考。MongoClientStringhostportMongoClientsSpring中文文档

ReactiveMongoDatabaseFactory

要使用反应式驱动程序连接到MongoDB,可以使用接口的实现。ReactiveMongoDatabaseFactorySpring中文文档

以下示例演示如何使用:SimpleReactiveMongoDatabaseFactorySpring中文文档

ReactiveMongoDatabaseFactory mongoDbFactory =
        new SimpleReactiveMongoDatabaseFactory(com.mongodb.reactivestreams.client.MongoClients.create(), "test");
<bean id="mongoDbFactory" class="o.s.data.mongodb.core.SimpleReactiveMongoDatabaseFactory">
    <constructor-arg>
        <bean class="com.mongodb.reactivestreams.client.MongoClients" factory-method="create"/>
    </constructor-arg>
    <constructor-arg value="test"/>
</bean>
Spring Data 默认提供阻塞 MongoDB 驱动程序,但您可以通过包含上述依赖项来选择被动使用。

MongoDB 消息存储

《企业集成模式 (EIP)》一书中所述,消息存储允许您持久化消息。 如果可靠性是一个问题,那么在处理能够缓冲消息(、、 等)的组件时,这样做会很有用。 在 Spring Integration 中,该策略还为声明检查模式提供了基础,这在 EIP 中也有描述。QueueChannelaggregatorresequencerMessageStoreSpring中文文档

Spring Integration 的 MongoDB 模块提供了 ,它是策略(主要由声明检查模式使用)和策略(主要由聚合器和重排序器模式使用)的实现。MongoDbMessageStoreMessageStoreMessageGroupStoreSpring中文文档

以下示例将 a 配置为使用 a 和 an:MongoDbMessageStoreQueueChannelaggregatorSpring中文文档

<bean id="mongoDbMessageStore" class="o.s.i.mongodb.store.MongoDbMessageStore">
    <constructor-arg ref="mongoDbFactory"/>
</bean>

<int:channel id="somePersistentQueueChannel">
    <int:queue message-store="mongoDbMessageStore"/>
<int:channel>

<int:aggregator input-channel="inputChannel" output-channel="outputChannel"
         message-store="mongoDbMessageStore"/>

前面的示例是一个简单的 Bean 配置,它需要 a 作为构造函数参数。MongoDbFactorySpring中文文档

使用 Spring Data Mongo 映射机制将 Mongo 文档扩展为具有所有嵌套属性的 Mongo 文档。 当您需要访问 or 以进行审核或分析(例如,针对存储的消息)时,它非常有用。MongoDbMessageStoreMessagepayloadheadersSpring中文文档

它使用自定义实现将实例存储为 MongoDB 文档,并且 的属性(和值)存在一些限制。MongoDbMessageStoreMappingMongoConverterMessagepayloadheaderMessage

从版本 5.1.6 开始,可以使用自定义转换器进行配置,这些转换器将传播到内部实现中。 有关更多信息,请参阅 JavaDocs。MongoDbMessageStoreMappingMongoConverterMongoDbMessageStore.setCustomConverters(Object…​ customConverters)Spring中文文档

Spring Integration 3.0 引入了 . 它实现了 和 接口。 此类可以接收 a 作为构造函数参数,例如,您可以使用它来配置自定义 . 另一个构造函数需要 a 和 a ,它允许您为实例及其属性提供一些自定义转换。 请注意,默认情况下,使用标准的 Java 序列化来写入和读取 MongoDB 中的实例(请参阅 ),并依赖于 中其他属性的默认值。 它从提供的 和 中构建 。 存储的集合的默认名称是 。 建议在消息包含复杂数据类型时,使用此实现创建可靠且灵活的解决方案。ConfigurableMongoDbMessageStoreMessageStoreMessageGroupStoreMongoTemplateWriteConcernMappingMongoConverterMongoDbFactoryMessageConfigurableMongoDbMessageStoreMessageMongoDbMessageBytesConverterMongoTemplateMongoTemplateMongoDbFactoryMappingMongoConverterConfigurableMongoDbMessageStoreconfigurableStoreMessagesSpring中文文档

从版本 6.0.8 开始,提供了一个(默认为 )选项,可用于禁用自动索引创建。 以下示例演示如何声明 Bean 并禁用自动索引创建:AbstractConfigurableMongoDbMessageStoresetCreateIndexes(boolean)trueSpring中文文档

@Bean
public MongoDbChannelMessageStore mongoDbChannelMessageStore(MongoDatabaseFactory databaseFactory) {
    MongoDbChannelMessageStore mongoDbChannelMessageStore = new MongoDbChannelMessageStore(databaseFactory);
    mongoDbChannelMessageStore.setCreateIndexes(false);
    return mongoDbChannelMessageStore;
}

MongoDB 通道消息存储库

4.0 版引入了新的 . 它针对实例使用进行了优化。 使用 ,您可以在实例中使用它来实现持久化消息的优先级轮询。 优先级 MongoDB 文档字段从 () 消息头填充。MongoDbChannelMessageStoreMessageGroupStoreQueueChannelpriorityEnabled = true<int:priority-queue>IntegrationMessageHeaderAccessor.PRIORITYprioritySpring中文文档

此外,所有 MongoDB 实例现在都有一个文档字段。 该值是针对同一集合中的简单文档执行操作的结果,该文档是按需创建的。 当消息存储在同一毫秒内时,该字段用于提供先进先出 (FIFO) 消息顺序(在优先级内,如果已配置)。MessageStoresequenceMessageGroupsequence$incsequencesequencepollSpring中文文档

我们不建议将同一 bean 用于优先级和非优先级,因为该选项适用于整个商店。 但是,这两种类型都可以使用相同的方法,因为来自存储的消息轮询是排序的,并且使用索引。 要配置该方案,可以从另一个消息存储库 Bean 扩展另一个消息存储 Bean,如以下示例所示:MongoDbChannelMessageStorepriorityEnabledcollectionMongoDbChannelMessageStore
<bean id="channelStore" class="o.s.i.mongodb.store.MongoDbChannelMessageStore">
    <constructor-arg name="mongoDbFactory" ref="mongoDbFactory"/>
</bean>

<int:channel id="queueChannel">
    <int:queue message-store="store"/>
</int:channel>

<bean id="priorityStore" parent="channelStore">
    <property name="priorityEnabled" value="true"/>
</bean>

<int:channel id="priorityChannel">
    <int:priority-queue message-store="priorityStore"/>
</int:channel>

使用禁用自动索引创建的 AbstractConfigurableMongoDbMessageStore

从版本 6.0.8 开始,实现了可用于禁用或启用(默认)自动索引创建。 下面的示例演示如何声明 Bean 并禁用自动索引创建:AbstractConfigurableMongoDbMessageStoresetCreateIndex(boolean)Spring中文文档

@Bean
public AbstractConfigurableMongoDbMessageStore mongoDbChannelMessageStore(MongoDatabaseFactory databaseFactory)
{
    AbstractConfigurableMongoDbMessageStore mongoDbChannelMessageStore = new MongoDbChannelMessageStore(databaseFactory);
    mongoDbChannelMessageStore.setCreateIndex(false);

    return mongoDbChannelMessageStore;
}

MongoDB 元数据存储

Spring Integration 4.2 引入了一个新的基于 MongoDB(参见元数据存储)的实现。 可以使用 在应用程序重新启动时维护元数据状态。 您可以将此新实现与适配器一起使用,例如:MetadataStoreMongoDbMetadataStoreMetadataStoreSpring中文文档

要指示这些适配器使用新的 ,请声明一个 Bean 名称为 的 Spring bean。 馈送入站通道适配器自动拾取并使用声明的 . 下面的示例演示如何声明名称为 :MongoDbMetadataStoremetadataStoreMongoDbMetadataStoremetadataStoreSpring中文文档

@Bean
public MetadataStore metadataStore(MongoDbFactory factory) {
    return new MongoDbMetadataStore(factory, "integrationMetadataStore");
}

还实现了 ,允许它在多个应用程序实例之间可靠地共享,其中只允许一个实例存储或修改键的值。 由于MongoDB的保证,所有这些操作都是原子的。MongoDbMetadataStoreConcurrentMetadataStoreSpring中文文档

它使用自定义实现将实例存储为 MongoDB 文档,并且 的属性(和值)存在一些限制。MongoDbMessageStoreMappingMongoConverterMessagepayloadheaderMessage
我们不建议将同一 bean 用于优先级和非优先级,因为该选项适用于整个商店。 但是,这两种类型都可以使用相同的方法,因为来自存储的消息轮询是排序的,并且使用索引。 要配置该方案,可以从另一个消息存储库 Bean 扩展另一个消息存储 Bean,如以下示例所示:MongoDbChannelMessageStorepriorityEnabledcollectionMongoDbChannelMessageStore

MongoDB 入站通道适配器

MongoDB 入站通道适配器是一个轮询使用者,它从 MongoDB 读取数据并将其作为有效负载发送。 以下示例演示如何配置 MongoDB 入站通道适配器:MessageSpring中文文档

<int-mongodb:inbound-channel-adapter id="mongoInboundAdapter"
       channel="replyChannel"
       query="{'name' : 'Bob'}"
       entity-class="java.lang.Object"
       auto-startup="false">
		<int:poller fixed-rate="100"/>
</int-mongodb:inbound-channel-adapter>

如前面的配置所示,您可以使用该元素并为各种属性提供值来配置 MongoDb 入站通道适配器,例如:inbound-channel-adapterSpring中文文档

  • query:JSON 查询(请参阅 MongoDB 查询)Spring中文文档

  • query-expression:计算结果为 JSON 查询字符串(如上述属性)或 的实例的 SpEL 表达式。 与属性互斥。queryo.s.data.mongodb.core.query.QueryquerySpring中文文档

  • entity-class:有效负载对象的类型。 如果未提供,则返回 a。com.mongodb.DBObjectSpring中文文档

  • collection-name或 :标识要使用的 MongoDB 集合的名称。collection-name-expressionSpring中文文档

  • mongodb-factory:对o.s.data.mongodb.MongoDbFactorySpring中文文档

  • mongo-template:对o.s.data.mongodb.core.MongoTemplateSpring中文文档

  • 所有其他入站适配器通用的其他属性(例如“channel”)。Spring中文文档

不能同时设置 和 。mongo-templatemongodb-factory

前面的示例相对简单且静态,因为它具有 的文本值,并使用 . 有时,您可能需要根据某些条件在运行时更改这些值。 为此,请使用它们的等效项 ( 和 ),其中提供的表达式可以是任何有效的 SpEL 表达式。querycollection-expressionquery-expressioncollection-name-expressionSpring中文文档

此外,您可能希望对从MongoDB读取的成功处理的数据进行一些后处理。 例如;您可能希望在处理文档后移动或删除文档。 您可以使用Spring Integration 2.2添加的事务同步功能来执行此操作,如以下示例所示:Spring中文文档

<int-mongodb:inbound-channel-adapter id="mongoInboundAdapter"
    channel="replyChannel"
    query-expression="new BasicQuery('{''name'' : ''Bob''}').limit(100)"
    entity-class="java.lang.Object"
    auto-startup="false">
        <int:poller fixed-rate="200" max-messages-per-poll="1">
            <int:transactional synchronization-factory="syncFactory"/>
        </int:poller>
</int-mongodb:inbound-channel-adapter>

<int:transaction-synchronization-factory id="syncFactory">
    <int:after-commit
        expression="@documentCleaner.remove(#mongoTemplate, payload, headers.mongo_collectionName)"
        channel="someChannel"/>
</int:transaction-synchronization-factory>

<bean id="documentCleaner" class="thing1.thing2.DocumentCleaner"/>

<bean id="transactionManager" class="o.s.i.transaction.PseudoTransactionManager"/>

以下示例显示了前面示例中引用的内容:DocumentCleanerSpring中文文档

public class DocumentCleaner {
    public void remove(MongoOperations mongoOperations, Object target, String collectionName) {
        if (target instanceof List<?> documents){
            for (Object document : documents) {
                mongoOperations.remove(new BasicQuery(JSON.serialize(document)), collectionName);
            }
        }
    }
}

您可以使用该元素将轮询器声明为事务性轮询器。 此元素可以引用实际的事务管理器(例如,如果流的其他部分调用 JDBC)。 如果你没有“真实”事务,你可以使用 的实例,它是 Spring 的实现,可以在没有实际事务时使用 Mongo 适配器的事务同步功能。transactionalo.s.i.transaction.PseudoTransactionManagerPlatformTransactionManagerSpring中文文档

这样做不会使MongoDB本身成为事务性的。 它允许在成功(提交)或失败(回滚)之前或之后执行操作的同步。

轮询器是事务性的,就可以设置 on 元素的实例。 A 创建 . 为方便起见,我们公开了一个默认的基于 SpEL 的表达式,它允许您配置 SpEL 表达式,其执行与事务协调(同步)。 支持提交前、提交后和回滚后事件的表达式,以及发送评估结果(如果有)的每个事件的通道。 对于每个子元素,您可以指定和属性。 如果仅存在该属性,则接收到的消息将作为特定同步方案的一部分发送到该位置。 如果仅存在该属性,并且表达式的结果为非 null 值,则会生成一条消息,并将结果作为有效负载发送到默认通道 () 并显示在日志中(在级别上)。 如果希望评估结果转到特定通道,请添加属性。 如果表达式的结果为 null 或 void,则不会生成任何消息。o.s.i.transaction.TransactionSynchronizationFactorytransactionalTransactionSynchronizationFactoryTransactionSynchronizationTransactionSynchronizationFactoryexpressionchannelchannelexpressionNullChannelDEBUGchannelSpring中文文档

有关事务同步的详细信息,请参阅事务同步Spring中文文档

从版本 5.5 开始,可以使用 配置 ,该 必须使用 MongoDb 语法计算为 a 或实例。 它可以用作上述后处理过程的替代方法,它修改从集合中提取的那些实体,因此在下一个轮询周期中不会再次从集合中提取它们(假设更新更改了查询中使用的某些值)。 当集群中使用同一集合的多个实例时,仍建议使用事务来实现执行隔离和数据一致性。MongoDbMessageSourceupdateExpressionStringupdateorg.springframework.data.mongodb.core.query.UpdateMongoDbMessageSourceSpring中文文档

不能同时设置 和 。mongo-templatemongodb-factory
这样做不会使MongoDB本身成为事务性的。 它允许在成功(提交)或失败(回滚)之前或之后执行操作的同步。

MongoDB 更改流入站通道适配器

从 5.3 版开始,该模块引入了 - Spring Data API 的响应式实现。 默认情况下,此组件会生成带有 of 作为有效负载的消息,并且会生成一些与更改流相关的标头(请参阅)。 建议将其与 a 结合使用,用于下游的按需订阅和事件消费。spring-integration-mongodbMongoDbChangeStreamMessageProducerMessageProducerSupportReactiveMongoOperations.changeStream(String, ChangeStreamOptions, Class)FluxbodyChangeStreamEventMongoHeadersMongoDbChangeStreamMessageProducerFluxMessageChanneloutputChannelSpring中文文档

此通道适配器的 Java DSL 配置可能如下所示:Spring中文文档

@Bean
IntegrationFlow changeStreamFlow(ReactiveMongoOperations mongoTemplate) {
    return IntegrationFlow.from(
            MongoDb.changeStreamInboundChannelAdapter(mongoTemplate)
                    .domainType(Person.class)
                    .collection("person")
                    .extractBody(false))
            .channel(MessageChannels.flux())
            .get();
}

当 停止,或订阅在下游被取消,或者 MongoDb 更改流生成 时,完成。 可以再次启动通道适配器,并创建一个新的源数据,并在 中自动订阅。 如果需要使用来自其他地方的更改流事件,则可以在启动之间为新选项重新配置此通道适配器。MongoDbChangeStreamMessageProducerOperationType.INVALIDATEPublisherPublisherMessageProducerSupport.subscribeToPublisher(Publisher<? extends Message<?>>)Spring中文文档

有关更改流支持的更多信息,请参阅Spring Data MongoDb文档Spring中文文档

MongoDB 出站通道适配器

MongoDB 出站通道适配器允许您将消息有效负载写入 MongoDB 文档存储,如以下示例所示:Spring中文文档

<int-mongodb:outbound-channel-adapter id="fullConfigWithCollectionExpression"
	collection-name="myCollection"
	mongo-converter="mongoConverter"
	mongodb-factory="mongoDbFactory" />

如前面的配置所示,您可以使用该元素配置 MongoDB 出站通道适配器,为各种属性提供值,例如:outbound-channel-adapterSpring中文文档

  • collection-name或 :标识要使用的 MongoDb 集合的名称。collection-name-expressionSpring中文文档

  • mongo-converter:对有助于将原始 Java 对象转换为 JSON 文档表示形式的实例的引用。o.s.data.mongodb.core.convert.MongoConverterSpring中文文档

  • mongodb-factory:对 的实例的引用。o.s.data.mongodb.MongoDbFactorySpring中文文档

  • mongo-template:对 的实例的引用。 注意:您不能同时设置 mongo-template 和 mongodb-factory。o.s.data.mongodb.core.MongoTemplateSpring中文文档

  • 所有入站适配器(如“channel”)中共有的其他属性。Spring中文文档

前面的示例相对简单且静态,因为它具有 . 有时,您可能需要在运行时根据某些条件更改此值。 为此,请使用 ,其中提供的表达式是任何有效的 SpEL 表达式。collection-namecollection-name-expressionSpring中文文档

MongoDB 出站网关

版本 5.0 引入了 MongoDB 出站网关。 它允许您通过向数据库的请求通道发送消息来查询数据库。 然后,网关将响应发送到应答通道。 可以使用消息负载和标头来指定查询和集合名称,如以下示例所示:Spring中文文档

@SpringBootApplication
public class MongoDbJavaApplication {

    public static void main(String[] args) {
        new SpringApplicationBuilder(MongoDbJavaApplication.class)
            .web(false)
            .run(args);
    }

    @Autowired
    private MongoDbFactory;

    @Autowired
    private MongoConverter;


    @Bean
    public IntegrationFlow gatewaySingleQueryFlow() {
        return f -> f
                .handle(queryOutboundGateway())
                .channel(c -> c.queue("retrieveResults"));
    }

    private MongoDbOutboundGatewaySpec queryOutboundGateway() {
        return MongoDb.outboundGateway(this.mongoDbFactory, this.mongoConverter)
                .query("{name : 'Bob'}")
                .collectionNameFunction(m -> m.getHeaders().get("collection"))
                .expectSingleResult(true)
                .entityClass(Person.class);
    }

}
class MongoDbKotlinApplication {

    fun main(args: Array<String>) = runApplication<MongoDbKotlinApplication>(*args)

    @Autowired
    lateinit var mongoDbFactory: MongoDatabaseFactory

    @Autowired
    lateinit var mongoConverter: MongoConverter

    @Bean
    fun gatewaySingleQueryFlow() =
    integrationFlow {
        handle(queryOutboundGateway())
        channel { queue("retrieveResults") }
    }

    private fun queryOutboundGateway(): MongoDbOutboundGatewaySpec {
        return MongoDb.outboundGateway(this.mongoDbFactory, this.mongoConverter)
            .query("{name : 'Bob'}")
            .collectionNameFunction<Any> { m -> m.headers["collection"] as String }
            .expectSingleResult(true)
            .entityClass(Person::class.java)
    }

}
@SpringBootApplication
public class MongoDbJavaApplication {

    public static void main(String[] args) {
        new SpringApplicationBuilder(MongoDbJavaApplication.class)
            .web(false)
            .run(args);
    }

    @Autowired
    private MongoDbFactory mongoDbFactory;

    @Bean
    @ServiceActivator(inputChannel = "requestChannel")
    public MessageHandler mongoDbOutboundGateway() {
        MongoDbOutboundGateway gateway = new MongoDbOutboundGateway(this.mongoDbFactory);
        gateway.setCollectionNameExpressionString("'myCollection'");
        gateway.setQueryExpressionString("'{''name'' : ''Bob''}'");
        gateway.setExpectSingleResult(true);
        gateway.setEntityClass(Person.class);
        gateway.setOutputChannelName("replyChannel");
        return gateway;
    }

    @Bean
    @ServiceActivator(inputChannel = "replyChannel")
    public MessageHandler handler() {
        return message -> System.out.println(message.getPayload());
    }
}
<int-mongodb:outbound-gateway id="gatewayQuery"
    mongodb-factory="mongoDbFactory"
    mongo-converter="mongoConverter"
    query="{firstName: 'Bob'}"
    collection-name="myCollection"
    request-channel="in"
    reply-channel="out"
    entity-class="org.springframework.integration.mongodb.test.entity$Person"/>

您可以将以下属性用于 MongoDB 出站网关:Spring中文文档

  • collection-name或 :标识要使用的 MongoDB 集合的名称。collection-name-expressionSpring中文文档

  • mongo-converter:对有助于将原始 Java 对象转换为 JSON 文档表示形式的实例的引用。o.s.data.mongodb.core.convert.MongoConverterSpring中文文档

  • mongodb-factory:对 的实例的引用。o.s.data.mongodb.MongoDbFactorySpring中文文档

  • mongo-template:对 的实例的引用。 注意:您不能同时设置 和 。o.s.data.mongodb.core.MongoTemplatemongo-templatemongodb-factorySpring中文文档

  • entity-class:要传递给 MongoTemplate 中的 and 方法的实体类的完全限定名称。 如果未提供此属性,则默认值为 。find(..)findOne(..)org.bson.DocumentSpring中文文档

  • query或 :指定 MongoDB 查询。 有关更多查询示例,请参阅 MongoDB 文档query-expressionSpring中文文档

  • collection-callback:对 的实例的引用。 最好是具有请求消息上下文的 5.0.11 以来的实例。 有关详细信息,请参阅其 Javadocs。 注意:您不能同时拥有这两个属性和任何一个查询属性。org.springframework.data.mongodb.core.CollectionCallbacko.s.i.mongodb.outbound.MessageCollectionCallbackcollection-callbackSpring中文文档

作为 and 属性的替代属性,可以通过使用该属性作为对功能接口实现的引用来指定其他数据库操作。 以下示例指定计数操作:queryquery-expressioncollectionCallbackMessageCollectionCallbackSpring中文文档

private MongoDbOutboundGatewaySpec collectionCallbackOutboundGateway() {
    return MongoDb.outboundGateway(this.mongoDbFactory, this.mongoConverter)
            .collectionCallback((collection, requestMessage) -> collection.count())
            .collectionName("myCollection");
}

MongoDB 反应式通道适配器

从版本 5.3 开始,提供了 和 实现。 它们基于 Spring 数据,需要依赖项。ReactiveMongoDbStoringMessageHandlerReactiveMongoDbMessageSourceReactiveMongoOperationsorg.mongodb:mongodb-driver-reactivestreamsSpring中文文档

这是当集成流定义中涉及反应式流组合时,框架中本机支持的实现。 有关详细信息,请参阅 ReactiveMessageHandlerReactiveMongoDbStoringMessageHandlerReactiveMessageHandlerSpring中文文档

从配置的角度来看,与许多其他标准通道适配器没有区别。 例如,对于 Java DSL,这样的通道适配器可以像这样使用:Spring中文文档

@Bean
public IntegrationFlow reactiveMongoDbFlow(ReactiveMongoDatabaseFactory mongoDbFactory) {
    return f -> f
            .channel(MessageChannels.flux())
            .handle(MongoDb.reactiveOutboundChannelAdapter(mongoDbFactory));
}

在此示例中,我们将通过提供的连接到 MongoDb,并将请求消息中的数据存储到具有名称的默认集合中。 实际操作将从内部创建的反应式流组合中按需执行。ReactiveMongoDatabaseFactorydataReactiveStreamsConsumerSpring中文文档

它是一种基于提供的或和MongoDb查询(或表达式)的实现,根据具有预期类型的选项调用或操作来转换查询结果。 当订阅了生成消息的有效负载中的(或根据选项)时,将按需执行查询执行和结果评估。 该框架可以在拆分器时自动(基本上)订阅这样的有效载荷,并在下游使用。 否则,目标应用程序负责订阅下游终结点中的轮询发布者。ReactiveMongoDbMessageSourceAbstractMessageSourceReactiveMongoDatabaseFactoryReactiveMongoOperationsfind()findOne()expectSingleResultentityClassPublisherFluxMonoexpectSingleResultflatMapFluxMessageChannelSpring中文文档

使用 Java DSL,可以按以下方式配置此类通道适配器:Spring中文文档

@Bean
public IntegrationFlow reactiveMongoDbFlow(ReactiveMongoDatabaseFactory mongoDbFactory) {
    return IntegrationFlow
            .from(MongoDb.reactiveInboundChannelAdapter(mongoDbFactory, "{'name' : 'Name'}")
                            .entityClass(Person.class),
                    c -> c.poller(Pollers.fixedDelay(1000)))
            .split()
            .channel(c -> c.flux("output"))
            .get();
}

从版本 5.5 开始,可以使用 . 它具有与阻止相同的功能。 有关更多信息,请参阅 MongoDB Inbound Channel Adapter 和 JavaDocs。ReactiveMongoDbMessageSourceupdateExpressionMongoDbMessageSourceAbstractMongoDbMessageSourceSpecSpring中文文档