前言

需求

本节详细介绍了兼容的 JavaSpring Framework 版本。

兼容的 Java 版本

对于 Spring Integration 6.3.x,最低兼容的 Java 版本是 Java SE 17。不支持旧版本的 Java。

兼容的 Spring Framework 版本

Spring Integration 6.3.x 需要 Spring Framework 6.1 或更高版本。

代码规范

Spring Framework 2.0 引入了对命名空间的支持,这简化了应用程序上下文的 XML 配置,并使 Spring Integration 能够提供广泛的命名空间支持。

在本参考指南中,int 命名空间前缀用于 Spring Integration 的核心命名空间支持。每个 Spring Integration 适配器类型(也称为模块)都提供自己的命名空间,可以通过以下约定进行配置

以下示例展示了 intint-eventint-stream 命名空间的使用

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:int="http://www.springframework.org/schema/integration"
  xmlns:int-webflux="http://www.springframework.org/schema/integration/webflux"
  xmlns:int-stream="http://www.springframework.org/schema/integration/stream"
  xsi:schemaLocation="
   http://www.springframework.org/schema/beans
   https://www.springframework.org/schema/beans/spring-beans.xsd
   http://www.springframework.org/schema/integration
   https://www.springframework.org/schema/integration/spring-integration.xsd
   http://www.springframework.org/schema/integration/webflux
   https://www.springframework.org/schema/integration/webflux/spring-integration-webflux.xsd
   http://www.springframework.org/schema/integration/stream
   https://www.springframework.org/schema/integration/stream/spring-integration-stream.xsd">
…
</beans>

有关 Spring Integration 命名空间支持的详细说明,请参阅 命名空间支持

命名空间前缀可以自由选择。您甚至可以选择根本不使用任何命名空间前缀。因此,您应该应用最适合您的应用程序的约定。但是请注意,SpringSource Tool Suite™ (STS) 使用与本参考指南中相同的命名空间约定来使用 Spring Integration。

本指南中的约定

在某些情况下,为了在指定长完全限定类名时帮助格式化,我们将 org.springframework 缩短为 o.s,并将 org.springframework.integration 缩短为 o.s.i,例如 o.s.i.transaction.TransactionSynchronizationFactory

反馈和贡献

对于操作指南问题或诊断或调试问题,我们建议使用 Stack Overflow。点击 这里 查看最新问题的列表。如果您相当确定 Spring Integration 中存在问题,或者想建议一个功能,请使用 GitHub 问题

如果您有解决方案或建议的修复方法,您可以在 GitHub 上提交拉取请求。但是,请记住,对于除最琐碎的问题之外的所有问题,我们希望在问题跟踪器中提交票证,在那里进行讨论并留下记录以供将来参考。

有关更多详细信息,请参阅 CONTRIBUTING 的顶层项目页面上的指南。

入门

如果您刚开始使用 Spring Integration,您可能希望通过创建一个基于 Spring Boot 的应用程序来开始。Spring Boot 提供了一种快速(且有见地的)方法来创建生产就绪的基于 Spring 的应用程序。它基于 Spring Framework,优先考虑约定而不是配置,旨在让您尽快启动并运行。

您可以使用 start.spring.io 生成一个基本项目(添加 integration 作为依赖项)或遵循其中一个 "入门"指南,例如 入门构建集成数据。这些指南不仅更容易理解,而且非常注重任务,并且大多数指南都基于 Spring Boot。