对于最新的稳定版本,请使用 Spring Integration 6.4.0spring-doc.cn

Apache Cassandra 支持

Spring 集成提供了通道适配器(从版本 6.0 开始),用于对 Apache Cassandra 集群执行数据库操作。 它完全基于 Spring Data for Apache Cassandra 项目。spring-doc.cn

您需要将此依赖项包含在您的项目中:spring-doc.cn

<dependency>
    <groupId>org.springframework.integration</groupId>
    <artifactId>spring-integration-cassandra</artifactId>
    <version>6.2.11</version>
</dependency>
compile "org.springframework.integration:spring-integration-cassandra:6.2.11"

Cassandra 出站组件

这是一个实现,可以在 one-way (default) 和 request-reply 模式 (一个选项) 下工作。 默认情况下,它是异步的(用于重置),并针对提供的 . 操作类型可以通过选项进行配置。 将模式设置为 ;或 或 将模式设置为 .CassandraMessageHandlerAbstractReplyProducingMessageHandlerproducesReplysetAsync(false)INSERTUPDATEDELETESTATEMENTReactiveCassandraOperationsCassandraMessageHandler.TypeingestQueryINSERTquerystatementExpressionstatementProcessorSTATEMENTspring-doc.cn

以下代码片段演示了此通道适配器或网关的各种配置:spring-doc.cn

@Bean
IntegrationFlow cassandraSelectFlow(ReactiveCassandraOperations cassandraOperations) {
    return flow -> flow
            .handle(Cassandra.outboundGateway(cassandraOperations)
                    .query("SELECT * FROM book WHERE author = :author limit :size")
                    .parameter("author", "payload")
                    .parameter("size", m -> m.getHeaders().get("limit")))
            .channel(c -> c.flux("resultChannel"));
}
@Bean
fun outboundReactive(cassandraOperations: ReactiveCassandraOperations) =
    integrationFlow {
        handle(
            Cassandra.outboundChannelAdapter(cassandraOperations)
                              .statementExpression("T(QueryBuilder).truncate('book').build()")
        ) { async(false) }
    }
@ServiceActivator(inputChannel = "cassandraSelectChannel")
@Bean
public MessageHandler cassandraMessageHandler() {
    CassandraMessageHandler cassandraMessageHandler = new CassandraMessageHandler(this.template);
    cassandraMessageHandler.setQuery("SELECT * FROM book WHERE author = :author limit :size");

    Map<String, Expression> params = new HashMap<>();
    params.put("author", PARSER.parseExpression("payload"));
    params.put("size", PARSER.parseExpression("headers.limit"));

    cassandraMessageHandler.setParameterExpressions(params);

    cassandraMessageHandler.setOutputChannel(resultChannel());
    cassandraMessageHandler.setProducesReply(true);
    return cassandraMessageHandler;
}
<int-cassandra:outbound-channel-adapter id="outboundAdapter"
                                        cassandra-template="cassandraTemplate"
                                        write-options="writeOptions"
                                        auto-startup="false"
                                        async="false"/>

<int-cassandra:outbound-gateway id="outgateway"
                                request-channel="input"
                                cassandra-template="cassandraTemplate"
                                mode="STATEMENT"
                                write-options="writeOptions"
                                query="SELECT * FROM book limit :size"
                                reply-channel="resultChannel"
                                auto-startup="true">
    <int-cassandra:parameter-expression name="author" expression="payload"/>
    <int-cassandra:parameter-expression name="size" expression="headers.limit"/>
</int-cassandra:outbound-gateway>

如果 a 在默认异步模式下用作网关,则会生成 a,该 a 将根据提供的实现进行处理。 对于真正的 reactive processing ,建议使用 a 作为 output channel configuration。 调用 In sync 模式以获取回复值。CassandraMessageHandlerMono<WriteResult>MessageChannelFluxMessageChannelMono.block()spring-doc.cn

如果执行 , 或 操作,则请求消息有效负载中需要一个实体(标记为 )。 如果有效负载是实体列表,则执行相应的批处理操作。INSERTUPDATEDELETEorg.springframework.data.cassandra.core.mapping.Tablespring-doc.cn

该模式期望有效负载以要插入的值矩阵的形式出现 - 。 例如,如果实体如下所示:ingestQueryList<List<?>>spring-doc.cn

@Table("book")
public record Book(@PrimaryKey String isbn,
                   String title,
                   @Indexed String author,
                   int pages,
                   LocalDate saleDate,
                   boolean isInStock) {

}

channel adapter 有这样的配置:spring-doc.cn

@Bean
public MessageHandler cassandraMessageHandler3() {
    CassandraMessageHandler cassandraMessageHandler = new CassandraMessageHandler(this.template);
    String cqlIngest = "insert into book (isbn, title, author, pages, saleDate, isInStock) values (?, ?, ?, ?, ?, ?)";
    cassandraMessageHandler.setIngestQuery(cqlIngest);
    cassandraMessageHandler.setAsync(false);
    return cassandraMessageHandler;
}

请求消息有效负载必须按如下方式转换:spring-doc.cn

List<List<Object>> ingestBooks =
    payload.stream()
            .map(book ->
                    List.<Object>of(
                            book.isbn(),
                            book.title(),
                            book.author(),
                            book.pages(),
                            book.saleDate(),
                            book.isInStock()))
            .toList();

对于更复杂的用例,有效负载可以作为 . 建议使用 API 构建各种语句以针对 Apache Cassandra 执行。 例如,要从表中删除所有数据,可以将具有此类有效负载的消息发送到 : 。 或者,对于基于请求消息的逻辑,可以提供 or 以基于该消息构建 。 为方便起见,a 被注册为 an 到 SPEL 评估上下文中,因此目标表达式可以像这样简单:com.datastax.oss.driver.api.core.cql.Statementcom.datastax.oss.driver.api.querybuilder.QueryBuilderBookCassandraMessageHandlerQueryBuilder.truncate("book").build()statementExpressionstatementProcessorCassandraMessageHandlerStatementcom.datastax.oss.driver.api.querybuilderimportspring-doc.cn

statement-expression="T(QueryBuilder).selectFrom("book").all()"

表示可绑定的命名查询参数,并且仅与选项一起使用。 请参阅上面提到的 Java 和 XML 示例。setParameterExpressions(Map<String, Expression> parameterExpressions)setQuery(String query)spring-doc.cn