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

Groovy 支持

在 Spring Integration 2.0 中,我们添加了 Groovy 支持,允许您使用 Groovy 脚本语言为各种集成组件提供逻辑,类似于 Spring 表达式语言 (SPEL) 支持路由、转换和其他集成问题的方式。 有关 Groovy 的更多信息,请参阅 Groovy 文档,您可以在项目网站上找到该文档。spring-doc.cn

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

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

此外,从 V6.0 开始,提供了用于集成流配置的 Groovy DSLspring-doc.cn

Groovy 配置

在 Spring Integration 2.1 中,Groovy 支持的配置名称空间是 Spring Integration 的脚本支持的扩展,并共享脚本支持部分中详细描述的核心配置和行为。 尽管通用脚本支持很好地支持 Groovy 脚本,但 Groovy 支持提供了配置名称空间,该名称空间由 Spring 框架和相关组件支持,为使用 Groovy 提供了扩展功能。 下面的清单显示了两个示例配置:Groovyorg.springframework.scripting.groovy.GroovyScriptFactoryspring-doc.cn

Filter
<int:filter input-channel="referencedScriptInput">
   <int-groovy:script location="some/path/to/groovy/file/GroovyFilterTests.groovy"/>
</int:filter>

<int:filter input-channel="inlineScriptInput">
     <int-groovy:script><![CDATA[
     return payload == 'good'
   ]]></int-groovy:script>
</int:filter>

如前面的示例所示,该配置看起来与常规脚本支持配置相同。 唯一的区别是使用 Groovy 命名空间,如命名空间前缀所示。 另请注意,标记上的属性在此命名空间中无效。int-groovylang<script>spring-doc.cn

Groovy 对象自定义

如果需要自定义 Groovy 对象本身(除了设置变量之外),则可以引用使用该属性实现的 Bean。 例如,如果要通过修改 和 registering 函数以在脚本中可用来实现域特定语言 (DSL),这可能很有用。 以下示例显示了如何执行此操作:GroovyObjectCustomizercustomizerMetaClassspring-doc.cn

<int:service-activator input-channel="groovyChannel">
    <int-groovy:script location="somewhere/SomeScript.groovy" customizer="groovyCustomizer"/>
</int:service-activator>

<beans:bean id="groovyCustomizer" class="org.something.MyGroovyObjectCustomizer"/>

设置 custom 与 elements 或 attribute 并不互斥。 也可以在定义内联脚本时提供。GroovyObjectCustomizer<variable>script-variable-generatorspring-doc.cn

Spring Integration 3.0 引入了该属性,该属性与该元素结合使用。 此外,如果未为绑定变量提供名称,则 groovy 脚本能够将变量解析为 中的 bean。 以下示例演示如何使用变量 ():variablesvariableBeanFactoryentityManagerspring-doc.cn

<int-groovy:script>
    <![CDATA[
        entityManager.persist(payload)
        payload
    ]]>
</int-groovy:script>

entityManager必须是应用程序上下文中的适当 Bean。spring-doc.cn

有关元素、属性和属性的更多信息,请参阅脚本变量绑定<variable>variablesscript-variable-generatorspring-doc.cn

Groovy Script 编译器定制

提示是最流行的 Groovy 编译器自定义选项。 它可以在类或方法级别使用。 有关更多信息,请参阅 Groovy 参考手册,特别是 @CompileStatic。 为了将此功能用于短脚本(在集成场景中),我们被迫将简单脚本更改为更类似于 Java 的代码。 请考虑以下脚本:@CompileStatic<filter>spring-doc.cn

headers.type == 'good'

前面的脚本在 Spring Integration 中成为以下方法:spring-doc.cn

@groovy.transform.CompileStatic
String filter(Map headers) {
	headers.type == 'good'
}

filter(headers)

这样,该方法被转换并编译为静态 Java 代码,绕过了 Groovy 调用的动态阶段,例如 factories 和 proxy。filter()getProperty()CallSitespring-doc.cn

从版本 4.3 开始,您可以使用选项配置 Spring 集成 Groovy 组件,指定应将 for 添加到内部。 有了这个,你可以在我们的脚本代码中省略方法声明 with,仍然可以获得编译的纯 Java 代码。 在这种情况下,前面的脚本可以很短,但仍需要比解释的脚本更详细一些,如下例所示:compile-staticbooleanASTTransformationCustomizer@CompileStaticCompilerConfiguration@CompileStaticspring-doc.cn

binding.variables.headers.type == 'good'

您必须通过属性访问 and(或任何其他)变量,因为使用 ,我们没有动态功能。headerspayloadgroovy.lang.Scriptbinding@CompileStaticGroovyObject.getProperty()spring-doc.cn

此外,我们还引入了 bean 引用。 使用此属性,您可以提供任何其他必需的 Groovy 编译器自定义,例如 . 有关此功能的更多信息,请参阅高级编译器配置的 Groovy 文档。compiler-configurationImportCustomizerspring-doc.cn

using 不会自动为 annotation 添加 an,它会覆盖该选项。 如果您仍然需要 ,则应手动将 添加到该自定义 中。compilerConfigurationASTTransformationCustomizer@CompileStaticcompileStaticCompileStaticnew ASTTransformationCustomizer(CompileStatic.class)CompilationCustomizerscompilerConfiguration
Groovy 编译器自定义对选项没有任何影响,并且可重新加载的脚本也可以静态编译。refresh-check-delay

控制总线

如 (企业集成模式) 中所述,控制总线背后的思想是,您可以使用与 “应用程序级” 消息传递相同的消息传递系统来监视和管理框架内的组件。 在 Spring 集成中,我们构建在前面描述的适配器之上,以便您可以发送消息作为调用公开操作的一种方式。 这些操作的一个选项是 Groovy 脚本。 下面的示例为 control bus 配置一个 Groovy 脚本:spring-doc.cn

<int-groovy:control-bus input-channel="operationChannel"/>

控制总线有一个 Importing 通道,可以访问该通道以调用应用程序上下文中 bean 上的操作。spring-doc.cn

Groovy 控制总线将 Importing 通道上的消息作为 Groovy 脚本运行。 它接受一条消息,将正文编译为脚本,使用 自定义它,然后运行它。 控制总线公开了应用程序上下文中的所有 bean,这些 bean 被 Spring 的接口注释并实现或扩展 Spring 的基类(例如,几个 和 实现)。GroovyObjectCustomizerMessageProcessor@ManagedResourceLifecycleCustomizableThreadCreatorTaskExecutorTaskSchedulerspring-doc.cn

在 Control Bus' 命令脚本中使用具有自定义作用域(例如 'request')的托管 bean 时要小心,尤其是在异步消息流中。 如果控制总线无法从应用程序上下文中公开 bean,则在命令脚本运行期间可能会得到一些 bean。 例如,如果未建立自定义范围的上下文,则尝试获取该范围内的 bean 会触发 .MessageProcessorBeansExceptionBeanCreationException

如果需要进一步自定义 Groovy 对象,还可以提供对通过该属性实现的 bean 的引用,如下例所示:GroovyObjectCustomizercustomizerspring-doc.cn

<int-groovy:control-bus input-channel="input"
        output-channel="output"
        customizer="groovyCustomizer"/>

<beans:bean id="groovyCustomizer" class="org.foo.MyGroovyObjectCustomizer"/>