Spring Integration6.3.0

扩展 Spring 编程模型以支持众所周知的 企业集成模式。Spring Integration 可以在基于 Spring 的应用程序中启用轻量级消息传递，并通过声明式适配器支持与外部系统的集成。这些适配器在 Spring 对远程处理、消息传递和调度的支持之上提供了更高级别的抽象。Spring Integration 的主要目标是提供一个简单的模型来构建企业集成解决方案，同时保持对可维护、可测试代码至关重要的关注点分离。

简介

使用 Spring 框架鼓励开发人员使用接口进行编码，并使用依赖注入 (DI) 为普通旧 Java 对象 (POJO) 提供执行其任务所需的依赖项。Spring Integration 将此概念更进一步，其中 POJO 使用消息范例连接在一起，并且各个组件可能不知道应用程序中的其他组件。此类应用程序通过组装细粒度可重用组件来形成更高级别的功能。通过精心设计，这些流程可以模块化，并且可以在更高级别上重复使用。

除了连接细粒度组件之外，Spring Integration 还提供了广泛的通道适配器和网关来与外部系统通信。通道适配器用于单向集成（发送或接收）；网关用于请求/响应场景（入站或出站）。有关适配器和网关的完整列表，请参阅参考文档。

Spring Cloud Stream 项目基于 Spring Integration，其中 Spring Integration 用作消息驱动的微服务的引擎。

功能

• 实现大多数企业集成模式

• 端点

• 通道（点对点和发布/订阅）

• 聚合器

• 过滤器

• 转换器

• 控制总线

• …

• 与外部系统的集成

• ReST/HTTP

• FTP/SFTP

• STOMP

• Web 服务（SOAP 和 RESTful）

• TCP/UDP

• JMS

• RabbitMQ

• 电子邮件

• …

• 该框架具有广泛的 JMX 支持

• 将框架组件公开为 MBean

• 适配器用于从 MBean 获取属性、调用操作、发送/接收通知

示例

在以下“快速入门”应用程序中，您可以看到使用相同的网关接口来调用两个完全不同的服务实现。要构建并运行此程序，您将需要如上所述的 spring-integration-ws 和 spring-integration-xml 模块。

public class Main {

	public static void main(String... args) throws Exception {
		ApplicationContext ctx =
			new ClassPathXmlApplicationContext("context.xml");
		// Simple Service
		TempConverter converter =
			ctx.getBean("simpleGateway", TempConverter.class);
		System.out.println(converter.fahrenheitToCelcius(68.0f));
		// Web Service
		converter  = ctx.getBean("wsGateway", TempConverter.class);
		System.out.println(converter.fahrenheitToCelcius(68.0f));
	}
}

public interface TempConverter {

	float fahrenheitToCelcius(float fahren);

}

<!-- Simple Service -->

<int:gateway id="simpleGateway"
	service-interface="foo.TempConverter"
	default-request-channel="simpleExpression" />

<int:service-activator id="expressionConverter"
	input-channel="simpleExpression"
	expression="(payload - 32) / 9 * 5"/>

<!-- Web Service -->

<int:gateway id="wsGateway" service-interface="foo.TempConverter"
	default-request-channel="viaWebService" />

<int:chain id="wsChain" input-channel="viaWebService">
	<int:transformer
	   expression="'&lt;FahrenheitToCelsius xmlns=&quot;https://w3schools.org.cn/xml/&quot;&gt;&lt;Fahrenheit&gt;XXX&lt;/Fahrenheit&gt;&lt;/FahrenheitToCelsius&gt;'.replace('XXX', payload.toString())" />
	<int-ws:header-enricher>
		<int-ws:soap-action value="https://w3schools.org.cn/xml/FahrenheitToCelsius"/>
	</int-ws:header-enricher>
	<int-ws:outbound-gateway
		uri="https://w3schools.org.cn/xml/tempconvert.asmx"/>
	<int-xml:xpath-transformer
		xpath-expression="/*[local-name()='FahrenheitToCelsiusResponse']/*[local-name()='FahrenheitToCelsiusResult']"/>
</int:chain>

以下是使用 Java DSL（和 Spring Boot）的相同应用程序（Web 服务部分）。如果您不使用 Spring Boot，您将需要 spring-boot-starter-integration 依赖项或直接使用 spring-integration-core

@SpringBootApplication
public class Application {

  public static void main(String[] args) {
    ConfigurableApplicationContext ctx = SpringApplication.run(Application.class, args);
    TempConverter converter = ctx.getBean(TempConverter.class);
    System.out.println(converter.fahrenheitToCelcius(68.0f));
    ctx.close();
  }

  @MessagingGateway
  public interface TempConverter {

    @Gateway(requestChannel = "convert.input")
    float fahrenheitToCelcius(float fahren);

  }

  @Bean
  public IntegrationFlow convert() {
      return f -> f
        .transform(payload ->
              "<FahrenheitToCelsius xmlns=\"https://w3schools.org.cn/xml/\">"
            +     "<Fahrenheit>" + payload + "</Fahrenheit>"
            + "</FahrenheitToCelsius>")
        .enrichHeaders(h -> h
            .header(WebServiceHeaders.SOAP_ACTION,
                "https://w3schools.org.cn/xml/FahrenheitToCelsius"))
        .handle(new SimpleWebServiceOutboundGateway(
            "https://w3schools.org.cn/xml/tempconvert.asmx"))
        .transform(Transformers.xpath("/*[local-name()=\"FahrenheitToCelsiusResponse\"]"
            + "/*[local-name()=\"FahrenheitToCelsiusResult\"]"));
  }

}