Kotlin DSL

Kotlin DSL 是 Java DSL 的包装器和扩展,旨在使 Spring Integration 在 Kotlin 上的开发尽可能地平滑和直接,并与现有的 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 用于 KotlinIntegrationFlowDefinitionIntegrationFlowDefinition 的 Kotlin 包装器),并生成一个常规的 IntegrationFlow lambda 实现。请参阅下面更多重载的 integrationFlow() 变体。

许多其他场景需要从数据源启动 IntegrationFlow(例如 JdbcPollingChannelAdapterJmsInboundGateway 或只是一个现有的 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") }
        }

此外,Kotlin 扩展为 Java DSL API 提供,该 API 需要针对 Kotlin 结构进行一些细化。例如,IntegrationFlowDefinition<*> 需要对许多带有 Class<P> 参数的方法进行具体化。

@Bean
fun convertFlow() =
    integrationFlow("convertFlowInput") {
        convert<TestPojo>()
    }
如果需要在运算符的 lambda 中访问标头,则具体化类型可以是整个 Message<*>