spring integration

Integrasi Musim Semi

Memperluas model pemrograman Spring untuk mendukung Pola Integrasi Perusahaan yang terkenal. Integrasi Spring memungkinkan pengiriman pesan ringan dalam aplikasi berbasis Spring dan mendukung integrasi dengan sistem eksternal melalui adaptor deklaratif. Adaptor tersebut memberikan tingkat abstraksi yang lebih tinggi atas dukungan Spring untuk jarak jauh, pengiriman pesan, dan penjadwalan. Tujuan utama Spring Integration adalah menyediakan model sederhana untuk membangun solusi integrasi perusahaan sambil mempertahankan pemisahan masalah yang penting untuk menghasilkan kode yang dapat dipelihara dan diuji.

Penggunaan Spring Framework mendorong pengembang untuk membuat kode menggunakan antarmuka dan menggunakan injeksi ketergantungan (DI) untuk menyediakan Objek Java Lama Biasa (POJO) dengan dependensi yang diperlukan untuk melakukan tugasnya. Integrasi Musim Semi membawa konsep ini satu langkah lebih jauh, di mana POJO dihubungkan bersama menggunakan paradigma pesan dan masing-masing komponen mungkin tidak mengetahui komponen lain dalam aplikasi. Aplikasi semacam itu dibangun dengan merakit komponen-komponen halus yang dapat digunakan kembali untuk membentuk fungsionalitas tingkat yang lebih tinggi. Dengan desain yang cermat, aliran ini dapat dimodulasi dan juga digunakan kembali pada tingkat yang lebih tinggi.

Selain menyatukan komponen-komponen halus, Spring Integration menyediakan beragam pilihan adaptor saluran dan gateway untuk berkomunikasi dengan sistem eksternal. Adaptor Saluran digunakan untuk integrasi satu arah (mengirim atau menerima); gateway digunakan untuk skenario permintaan/balasan (masuk atau keluar).

Instalasi dan Memulai

Pertama, Anda memerlukan dependensi di POM/Gradle Anda:

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

yang juga ditarik secara transitif jika Anda berurusan dengan adaptor saluran protokol target. Misalnya untuk dukungan Apache Kafka Anda hanya memerlukan ini:

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

Untuk anotasi atau konfigurasi Java DSL Anda perlu mengaktifkan Integrasi Pegas dalam konteks aplikasi:

 @ EnableIntegration
@ Configuration
public class ExampleConfiguration {
    
}

Kode Etik

Silakan lihat Kode Etik kami.

Melaporkan Kerentanan Keamanan

Silakan lihat kebijakan Keamanan kami.

Dokumentasi

Integrasi Musim Semi memelihara dokumentasi referensi (diterbitkan dan sumber), halaman wiki GitHub, dan referensi API. Ada juga panduan dan tutorial seputar proyek Musim Semi.

Memeriksa dan Membangun

Untuk memeriksa proyek dan membangun dari sumbernya, lakukan hal berikut:

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

or

./gradlew clean testAll

Yang terakhir menjalankan pengujian tambahan (yang dianotasi dengan @LongRunningIntegrationTest ); ini adalah pengujian yang lebih menyeluruh tetapi membutuhkan waktu lebih lama untuk dijalankan.

Hasil pengujian dicatat dalam build/reports/tests/test (atau .../testAll ) di bawah setiap modul (dalam format HTML).

Tambahkan --continue ke perintah untuk melakukan pembangunan lengkap, meskipun ada pengujian yang gagal di beberapa modul; jika tidak, pembangunan akan berhenti setelah modul yang sedang dibangun selesai.

CATATAN: Meskipun Integrasi Musim Semi berjalan dengan Java SE 17 atau lebih tinggi, kompiler Java 17 diperlukan untuk membangun proyek.

Untuk membuat dan memasang toples ke cache Maven lokal Anda:

 ./gradlew build publishToMavenLocal

Untuk membangun api Javadoc (hasilnya akan ada di build/api ):

 ./gradlew api

Untuk membuat dokumentasi referensi (hasilnya akan ada di build/site ):

 ./gradlew antora

Untuk membangun distribusi lengkap termasuk file zip -dist , -docs , dan -schema (hasilnya akan ada di build/distributions ):

 ./gradlew dist

Menggunakan Eclipse atau Spring Tool Suite (dengan Plugin BuildShip)

Jika Anda telah menginstal plugin BuildShip,

File -> Impor -> Gradle -> Proyek Gradle yang Ada

Menggunakan Eclipse atau Spring Tool Suite (bila Plugin BuildShip tidak diinstal)

Untuk menghasilkan metadata Eclipse (file .classpath dan .project, dll.), lakukan hal berikut:

 ./gradlew eclipse

Setelah selesai, Anda dapat mengimpor proyek ke Eclipse seperti biasa:

File -> Impor -> Umum -> Proyek yang ada ke ruang kerja

Telusuri ke direktori root 'integrasi pegas' . Semua proyek harus diimpor bebas dari kesalahan.

Menggunakan IntelliJ IDEA

Untuk mengimpor proyek ke IntelliJ IDEA:

File -> Buka... -> dan pilih build.gradle dari direktori root proyek integrasi pegas

Pedoman

Lihat juga Pedoman Kontributor.

Sumber daya

Untuk informasi lebih lanjut, silakan kunjungi situs web Spring Integration di: https://spring.io/projects/spring-integration