Groovy DSL

Groovy DSL 是对 Java DSL 的包装和扩展。我们在这里追求的主要目标是使 Spring Integration 在 Groovy 上的开发尽可能地平滑和直接,并与现有的 Java DSL 以及一些 Groovy 扩展或特定于语言的结构实现互操作性。该实现是 Groovy 支持 模块的一部分。

开始使用只需要导入import static org.springframework.integration.groovy.dsl.IntegrationGroovyDsl.integrationFlow - 一个包含 Groovy DSL 重载工厂方法的类。

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

@Bean
IntegrationFlow oddFlow() {
    { IntegrationFlowDefinition flow ->
	    flow.handle(Object, { p, h -> 'odd' })
    }
}

在这种情况下,Groovy 理解闭包应该被转换为IntegrationFlow 匿名实例,目标 Java DSL 处理器会将此构造正确解析为 Java 对象。

作为上述构造的替代方案,为了与下面解释的用例保持一致,spring-integration-groovy 模块提供了一个 Groovy 特定的 DSL,用于以**构建器**模式风格声明集成流

@Bean
flowLambda() {
    integrationFlow {
        filter String, { it == 'test' }, { id 'filterEndpoint' }
        wireTap integrationFlow {
            channel { queue 'wireTapChannel' }
        }
        delay {
		    messageGroupId 'delayGroup'
		    defaultDelay 100
        }
        transform {
		    transformer { it.toUpperCase() }
            expectedType String
        }
    }
}

这样的全局integrationFlow() 函数期望一个构建器风格的闭包,用于GroovyIntegrationFlowDefinitionIntegrationFlowDefinition 的 Groovy 包装器),并生成一个常规的IntegrationFlow lambda 实现。请参阅下面更多重载的integrationFlow() 变体。

许多其他场景需要从数据源启动IntegrationFlow(例如JdbcPollingChannelAdapterJmsInboundGateway 或只是一个现有的MessageChannel)。为此,Spring Integration Java DSL 提供了一个IntegrationFlow 工厂,它具有一系列重载的from() 方法。此工厂也可以在 groovy 中使用

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

但不幸的是,并非所有from() 方法都与 Groovy 结构兼容。为了解决这个问题,Spring Integration 在IntegrationFlow 工厂周围提供了一个 Groovy DSL 工厂。它被实现为一组重载的integrationFlow() 函数。使用GroovyIntegrationFlowDefinition 的消费者来声明流的剩余部分作为IntegrationFlow 闭包,以重用上面提到的经验,并避免在最后需要get() 调用。例如

@Bean
functionFlow() {
    integrationFlow Function<byte[], String>,
            { beanName 'functionGateway' },
            {
                transform {
		            transformer Transformers.objectToString()
                    id 'objectToStringTransformer'
                }
                transform {
		            transformer { it.toUpperCase() }
                    expectedType String
                }
                splitWith {
                    expectedType Message<?>
                    function { it.payload }
                }
                splitWith {
                    expectedType Object
                    id 'splitterEndpoint'
                    function { it }
                }
                resequence()
                aggregate {
                    id 'aggregator'
                    outputProcessor { it.one }
                }
            }
}

@Bean
someFlow() {
    integrationFlow ({ 'test' },
            {
                poller { it.trigger new OnlyOnceTrigger() }
                id 'pollingSource'
            })
            {
                log LoggingHandler.Level.WARN, 'test.category'
                channel { queue 'pollerResultChannel' }
            }
}