Preface

Requirements

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

Compatible Java Versions

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

Compatible Versions of the Spring Framework

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

Code Conventions

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 命名空间支持的详细说明,请参阅 Namespace Support

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

Conventions in This Guide

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

Feedback and Contributions

对于如何解决问题、诊断或调试问题,我们建议使用 Stack Overflow。单击 here 以获取最新问题列表。如果您比较确定 Spring Integration 中存在问题,或者想要提出一个新功能,请使用 GitHub Issues

如果您心中已有解决方案或建议的修复方案,则可以提交拉取请求到 GitHub。但是,请记住,对于所有最基本的问题,我们希望在问题跟踪器中提交工单,其中会进行讨论并为将来的参考留下记录。

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

Getting Started

如果您刚刚开始使用 Spring Integration,则可能想要通过创建基于 Spring Boot 的应用程序开始。Spring Boot 提供了一种快速(且主观的)方法来创建基于 Spring 的可用于生产环境的应用程序。它基于 Spring Framework,奉行惯例优于配置,并且旨在让您尽快启动并运行。

您可以使用 start.spring.io 生成一个基本项目(添加 integration 作为依赖项),或者按照其中一个 "Getting Started" guides,如 Getting Started Building an Integrating Data。这些指南除了比较容易理解之外,还非常注重于任务,且大多数是以 Spring Boot 为基础的。