Spring Integration7.0.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支持

• 将框架组件作为MBeans公开

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

示例

在下面的“快速启动”应用程序中，您可以看到相同的网关接口用于调用两个完全不同的服务实现。要构建和运行此程序，您将需要上述的 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\"]"));
  }

}