spring integration

彈簧集成

擴展 Spring 編程模型以支援眾所周知的企業整合模式。 Spring Integration 可以在基於 Spring 的應用程式中實現輕量級訊息傳遞，並支援透過聲明性適配器與外部系統整合。這些適配器提供了比 Spring 對遠端處理、訊息傳遞和調度的支援更高層級的抽象。 Spring Integration 的主要目標是提供一個簡單的模型來建立企業整合解決方案，同時保持關注點分離，這對於產生可維護、可測試的程式碼至關重要。

使用 Spring 框架鼓勵開發人員使用介面進行編碼，並使用依賴項注入 (DI) 為普通舊 Java 物件 (POJO) 提供執行其任務所需的依賴項。 Spring Integration 將這一概念更進一步，其中 POJO 使用訊息傳遞範例連接在一起，並且各個元件可能不知道應用程式中的其他元件。這樣的應用程式是透過組裝細粒度的可重複使用元件來建構的，以形成更高層級的功能。透過精心設計，這些流程可以模組化，並可以在更高的層級上重複使用。

除了將細粒度組件連接在一起之外，Spring Integration 還提供了多種通道適配器和網關來與外部系統進行通訊。通道適配器用於單向整合（發送或接收）；網關用於請求/回覆場景（入站或出站）。

安裝和入門

首先，您的 POM/Gradle 中需要依賴項：

< dependency >
    < groupId >org.springframework.integration</ groupId >
    < artifactId >spring-integration-core</ artifactId >
</ dependency >

如果您處理目標協定通道適配器，它也會被傳遞地拉取。例如，對於 Apache Kafka 支持，您只需要這樣：

< dependency >
    < groupId >org.springframework.integration</ groupId >
    < artifactId >spring-integration-kafka</ artifactId >
</ dependency >

對於註解或 Java DSL 配置，您需要在應用程式上下文中啟用Spring Integration：

 @ EnableIntegration
@ Configuration
public class ExampleConfiguration {
    
}

行為守則

請參閱我們的行為準則。

報告安全漏洞

請參閱我們的安全政策。

文件

Spring Integration 維護參考文件（已發佈和原始碼）、GitHub wiki 頁面和 API 參考。還有跨 Spring 專案的指南和教學。

檢出並構建

若要檢查專案並從原始程式碼構建，請執行以下操作：

 git clone git://github.com/spring-projects/spring-integration.git
cd spring-integration
./gradlew clean test

or

./gradlew clean testAll

後者執行額外的測試（那些用@LongRunningIntegrationTest註解的測試）；這是一個更徹底的測試，但運行時間要長得多。

測試結果在每個模組下的build/reports/tests/test （或.../testAll ）中捕獲（以 HTML 格式）。

在命令中加入--continue來執行完整的構建，即使某些模組中存在失敗的測試；否則，建置將在目前正在建置的模組完成後停止。

注意：雖然 Spring Integration 使用 Java SE 17 或更高版本運行，但需要 Java 17 編譯器來建置專案。

要建置 jar 並將其安裝到本機 Maven 快取中：

 ./gradlew build publishToMavenLocal

建構 api Javadoc（結果將位於build/api中）：

 ./gradlew api

建立參考文件（結果將位於build/site ）：

 ./gradlew antora

要建立完整的發行版，包括-dist 、 -docs和-schema zip 檔案（結果將在build/distributions中）：

 ./gradlew dist

使用 Eclipse 或 Spring Tool Suite（附 BuildShip 外掛程式）

如果您安裝了 BuildShip 插件，

文件 -> 導入 -> Gradle -> 現有 Gradle 項目

使用Eclipse或Spring Tool Suite（未安裝BuildShip外掛程式時）

若要產生 Eclipse 元資料（.classpath 和 .project 檔案等），請執行下列操作：

 ./gradlew eclipse

完成後，您可以像往常一樣將專案匯入到 Eclipse 中：

文件 -> 導入 -> 常規 -> 將現有項目放入工作區

瀏覽到“spring-integration”根目錄。所有項目的導入都應該沒有錯誤。

使用 IntelliJ IDEA

若要將專案匯入 IntelliJ IDEA：

檔案 -> 開啟... -> 並從 spring-integration 專案根目錄中選擇 build.gradle

指南

另請參閱貢獻者指南。

資源

欲了解更多信息，請訪問 Spring Integration 網站：https://spring.io/projects/spring-integration