Kotlin DSL

Kotlin DSL 是 Java DSL 的一个包装器和扩展，旨在使 Kotlin 上的 Spring Integration 开发尽可能流畅和简单，并与现有的 Java API 和 Kotlin 语言特定的结构实现互操作性。

要开始使用，您只需导入 org.springframework.integration.dsl.integrationFlow - Kotlin DSL 的一个重载全局函数。

对于作为 lambda 的 IntegrationFlow 定义，我们通常不需要 Kotlin 中的任何其他内容，只需像这样声明一个 bean

@Bean
fun oddFlow() =
IntegrationFlow { flow ->
    flow.handle<Any> { _, _ -> "odd" }
}

在这种情况下，Kotlin 理解 lambda 应该转换为 IntegrationFlow 匿名实例，并且目标 Java DSL 处理器会将此结构正确地解析为 Java 对象。

作为上述构造的替代方案，并且为了与下面解释的用例保持一致，应使用 Kotlin 特定的 DSL 以**构建器**模式样式声明集成流

@Bean
fun flowLambda() =
    integrationFlow {
        filter<String> { it === "test" }
        wireTap {
                    handle { println(it.payload) }
                }
        transform<String> { it.toUpperCase() }
    }

这样的全局 integrationFlow() 函数期望一个构建器样式的 lambda 用于 KotlinIntegrationFlowDefinition（IntegrationFlowDefinition 的 Kotlin 包装器），并生成一个常规的 IntegrationFlow lambda 实现。请参见下面更多重载的 integrationFlow() 变体。

许多其他场景需要从数据源启动 IntegrationFlow（例如 JdbcPollingChannelAdapter、JmsInboundGateway 或仅仅是现有的 MessageChannel）。为此，Spring Integration Java DSL 提供了一个 IntegrationFlow 流式 API 及其大量重载的 from() 方法。此 API 也可在 Kotlin 中使用

@Bean
fun flowFromSupplier() =
         IntegrationFlow.fromSupplier({ "bar" }) { e -> e.poller { p -> p.fixedDelay(10).maxMessagesPerPoll(1) } }
                 .channel { c -> c.queue("fromSupplierQueue") }
                 .get()

但不幸的是，并非所有 from() 方法都与 Kotlin 结构兼容。为了解决这个问题，此项目在 IntegrationFlow 流式 API 周围提供了一个 Kotlin DSL。它实现为一组重载的 integrationFlow() 函数。使用 KotlinIntegrationFlowDefinition 的消费者来声明流的其余部分作为 IntegrationFlow lambda 以重用上面提到的经验，并避免在最后调用 get()。例如

@Bean
fun functionFlow() =
        integrationFlow<Function<String, String>>({ beanName("functionGateway") }) {
            transform<String> { it.toUpperCase() }
        }

@Bean
fun messageSourceFlow() =
        integrationFlow(MessageProcessorMessageSource { "testSource" },
                { poller { it.fixedDelay(10).maxMessagesPerPoll(1) } }) {
            channel { queue("fromSupplierQueue") }
        }

此外，还为 Java DSL API 提供了 Kotlin 扩展，这些 API 需要对 Kotlin 结构进行一些改进。例如，IntegrationFlowDefinition<*> 需要为许多带有 Class<P> 参数的方法进行具现化

@Bean
fun convertFlow() =
    integrationFlow("convertFlowInput") {
        convert<TestPojo>()
    }

如果在运算符的 lambda 中也需要访问标头，则具现化的类型可以是整个 Message<*>。