序言

要求

本節詳細介紹了相容的 JavaSpring Framework 版本。

相容的 Java 版本

對於 Spring Integration 6.4.x,最低相容的 Java 版本是 Java SE 17。不支援更舊的 Java 版本。

Spring Framework 的相容版本

Spring Integration 6.4.x 需要 Spring Framework 6.2 或更高版本。

程式碼約定

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 Issues

如果您有解決方案或建議的修復,可以在 GitHub 上提交 Pull Request。但請記住,除了最微不足道的問題外,我們期望在問題跟蹤器中提交工單,以便進行討論並留下記錄以供將來參考。

更多詳情請參閱 CONTRIBUTING 頂級專案頁面的指南。

入門

如果您剛開始接觸 Spring Integration,可以從建立一個基於 Spring Boot 的應用開始。Spring Boot 提供了一種快速(且帶有觀點)的方式來建立生產就緒的 Spring 應用。它基於 Spring Framework,傾向於約定優於配置,旨在讓您儘快上手並執行起來。

您可以使用 start.spring.io 生成一個基本專案(新增 integration 作為依賴),或者參考其中一個 "入門"指南,例如 構建整合資料的入門指南。這些指南不僅更容易理解,而且非常注重任務,並且大多數都是基於 Spring Boot 的。