Panduan migrasi untuk Spring Cloud Azure 4.0

Panduan ini membantu migrasi ke Spring Cloud Azure 4.0 dari pustaka warisan Azure Spring.

Perkenalan

Kami akan memanggil pustaka yang ID grup dan ID artefaknya mengikuti pola pustaka modern , dan pustaka dengan pola , , atau pustaka warisan .

Panduan ini akan berfokus pada perbandingan berdampingan untuk konfigurasi serupa antara pustaka modern dan warisan.

Pemahaman tentang paket com.azure.spring:azure-spring-boot-*, com.azure.spring:azure-spring-cloud-*, atau com.azure.spring:azure-spring-integration-* diasumsikan.

Jika Anda baru menggunakan pustaka Spring Cloud Azure 4.0, lihat panduan pengembang Spring Cloud Azure daripada panduan ini.

Manfaat migrasi

Pertanyaan alami untuk ditanyakan ketika mempertimbangkan apakah akan mengadopsi versi atau pustaka baru adalah manfaatnya. Karena Azure telah matang dan dirangkul oleh sekelompok pengembang yang lebih beragam, kami telah berfokus pada pembelajaran pola dan praktik untuk mendukung produktivitas pengembang dengan sebaik-baiknya dan untuk memahami kesenjangan yang dimiliki pustaka Spring Cloud Azure.

Ada beberapa area umpan balik konsisten yang dinyatakan di seluruh pustaka Spring Cloud Azure. Yang paling penting adalah bahwa pustaka untuk layanan Azure yang berbeda belum mengaktifkan serangkaian konfigurasi lengkap. Selain itu, inkonsistensi penamaan proyek, ID artefak, versi, dan konfigurasi membuat kurva pembelajaran terjal.

Untuk meningkatkan pengalaman pengembangan di seluruh pustaka Spring Cloud Azure, serangkaian pedoman desain diperkenalkan untuk memastikan bahwa pustaka Spring Cloud Azure memiliki nuansa alami dan idiomatik sehubungan dengan ekosistem Spring. Detail lebih lanjut tersedia dalam dokumen design bagi mereka yang tertarik.

Spring Cloud Azure 4.0 memberikan pengalaman bersama di seluruh pustaka yang terintegrasi dengan proyek Spring yang berbeda, misalnya Spring Boot, Spring Integration, Spring Cloud Stream, dan sebagainya. Pengalaman bersama meliputi:

• BOM terpadu untuk menyertakan semua pustaka Spring Cloud Azure 4.0.
• Konvensi penamaan yang konsisten untuk artefak.
• Cara terpadu untuk mengonfigurasi kredensial, proksi, coba lagi, lingkungan cloud, dan pengaturan lapisan transportasi.
• Mendukung semua metode autentikasi yang didukung Azure Service atau Azure Service SDK.

Ikhtisar

Panduan migrasi ini terdiri dari bagian berikut:

• Perubahan penamaan untuk Spring Cloud Azure 4.0
• Perubahan artefak: diganti namanya / ditambahkan / dihapus
• Perubahan dependensi
• Perubahan autentikasi
• Properti konfigurasi
• Perubahan pemecahan API
• Perubahan pustaka

Penamaan perubahan

Tidak pernah ada nama yang konsisten atau resmi untuk memanggil semua pustaka Azure Spring Cloud. Beberapa di antaranya disebut Azure Spring Boot dan beberapa di antaranya Spring on Azure. Sejak 4.0, kami mulai menggunakan nama proyek Spring Cloud Azure untuk mewakili semua pustaka Azure Spring.

BOM

Kami biasa mengirim dua BOM untuk pustaka kami, azure-spring-boot-bom dan azure-spring-cloud-dependencies, tetapi kami menggabungkan kedua BOM ini menjadi satu BOM sejak 4.0, spring-cloud-azure-dependencies. Tambahkan entri di bagian dependencyManagement proyek Anda untuk mendapatkan manfaat dari manajemen dependensi.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>7.3.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Perubahan artefak: diganti namanya / ditambahkan / dihapus

ID grup sama untuk pustaka Azure Spring Cloud modern dan warisan. Mereka semua com.azure.spring. ID artefak untuk pustaka Spring Cloud Azure modern telah berubah. Menurut proyek Spring miliknya, Spring Boot, Spring Integration, atau Spring Cloud Stream, pola ID artefak dapat spring-cloud-azure-starter-[service], spring-integration-azure-[service], atau spring-cloud-azure-stream-binder-[service]. Permulaan warisan untuk masing-masing memiliki ID artefak setelah pola azure-spring-*. Ini menyediakan cara yang cepat dan dapat diakses untuk membantu memahami, sekilas, baik Anda menggunakan pemula modern atau warisan.

Dalam proses pengembangan Spring Cloud Azure 4.0, kami mengganti nama beberapa artefak untuk membuatnya mengikuti konvensi penamaan baru, menghapus beberapa artefak sehingga fungsionalitas dapat dimasukkan ke dalam artefak yang lebih tepat, dan menambahkan beberapa artefak baru untuk melayani beberapa skenario dengan lebih baik.

Tabel berikut menunjukkan pemetaan antara ID artefak warisan dan ID artefak modern:

Perubahan dependensi

Beberapa dependensi yang tidak perlu disertakan dalam artefak warisan, yang telah kami hapus di pustaka Spring Cloud Azure 4.0 modern. Pastikan untuk menambahkan dependensi yang dihapus secara manual ke proyek Anda untuk mencegah crash.

Pustaka yang memiliki perubahan dependensi meliputi:

• spring-cloud-azure-starter
• spring-cloud-azure-starter-active-directory
• spring-cloud-azure-starter-active-directory-b2c

Perubahan autentikasi

Spring Cloud Azure 4.0 mendukung semua metode autentikasi yang didukung setiap Azure Service SDK. Ini memungkinkan Anda untuk mengonfigurasi kredensial token global serta memberikan kredensial token di setiap tingkat layanan. Tetapi kredensial tidak diperlukan untuk mengonfigurasi Spring Cloud Azure 4.0 karena dapat menerapkan kredensial yang disimpan di lingkungan pengembangan lokal atau identitas terkelola di Azure Services. Pastikan perwakilan telah diberikan izin yang memadai untuk mengakses sumber daya Azure target.

Kredensial berantai, kacang DefaultAzureCredential dikonfigurasi secara otomatis secara default dan akan digunakan oleh semua komponen jika tidak ada lagi informasi autentikasi yang ditentukan. Untuk informasi selengkapnya, lihat bagian DefaultAzureCredential pustaka klien Azure Identity untuk Java.

Properti konfigurasi

Migrasi properti

Kami telah membuat additional-spring-configuration-metadata.json file untuk memuluskan migrasi properti saat menggunakan dengan spring-boot-properties-migrator. Pertama, tambahkan migrasi properti berikut ke aplikasi Anda:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

Atau, jika Anda menggunakan Gradle:

runtime("org.springframework.boot:spring-boot-properties-migrator")

Jika Anda menjalankan aplikasi, aplikasi akan mengidentifikasi properti yang tidak lagi dikelola oleh Spring Cloud Azure. Jika ada penggantian, properti tersebut akan memetakan ulang properti untuk Anda sementara dengan peringatan. Jika tidak ada penggantian, laporan kesalahan akan memberi Anda informasi lebih lanjut. Bagaimanapun, konfigurasi harus diperbarui dan dependensi dihapus setelah Anda memperbarui konfigurasi.

Sebelum melanjutkan, ada baiknya menggunakan fitur pencarian IDE Anda untuk memeriksa kembali apakah Anda tidak menggunakan salah satu properti yang telah Anda migrasikan dalam pengujian integrasi.

Konfigurasi global

spring-cloud-azure-starter modern memungkinkan Anda menentukan properti yang berlaku untuk semua Azure SDK di namespace spring.cloud.azure. Fitur ini tidak didukung di azure-spring-boot-starterwarisan. Konfigurasi global dapat dibagi menjadi lima kategori, yang diperlihatkan dalam tabel berikut:

Untuk daftar lengkap konfigurasi, lihat properti konfigurasi Spring Cloud Azure.

Mengonfigurasi setiap SDK

Untuk detail tentang opsi konfigurasi di tingkat SDK, gunakan tautan berikut:

• Dari azure-spring-boot-starter-active-directory ke spring-cloud-azure-starter-active-directory
• Dari azure-spring-boot-starter-active-directory-b2c ke spring-cloud-azure-starter-active-directory-b2c
• Dari azure-spring-boot-starter-cosmos ke spring-cloud-azure-starter-data-cosmos
• Dari azure-spring-boot-starter-keyvault-secrets ke spring-cloud-azure-starter-keyvault-secrets
• Dari azure-spring-boot-starter-servicebus-jms ke spring-cloud-azure-starter-servicebus-jms
• Dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-blob
• Dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-file-share
• Dari azure-spring-cloud-starter-eventhubs ke spring-cloud-azure-starter-integration-eventhubs
• Dari azure-spring-cloud-starter-servicebus ke spring-cloud-azure-starter-integration-servicebus
• Dari azure-spring-cloud-starter-storage-queue ke spring-cloud-azure-starter-integration-storage-queue
• Dari azure-spring-cloud-stream-binder-eventhubs ke spring-cloud-azure-stream-binder-eventhubs
• Dari azure-spring-cloud-stream-binder-servicebus-* ke spring-cloud-azure-stream-binder-servicebus

Perubahan pemecahan API

Untuk detail tentang perubahan pemecahan API di setiap pustaka, gunakan tautan berikut:

• Dari azure-spring-boot-starter-active-directory ke spring-cloud-azure-starter-active-directory
• Dari azure-spring-boot-starter-active-directory-b2c ke spring-cloud-azure-starter-active-directory-b2c
• Dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-blob
• Dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-file-share
• Dari azure-spring-cloud-starter-eventhubs ke spring-cloud-azure-starter-integration-eventhubs
• Dari azure-spring-integration-eventhubs ke spring-integration-azure-eventhubs
• Dari azure-spring-cloud-starter-servicebus ke spring-cloud-azure-starter-integration-servicebus
• Dari azure-spring-integration-servicebus ke spring-integration-azure-servicebus
• Dari azure-spring-cloud-starter-storage-queue ke spring-cloud-azure-starter-integration-storage-queue
• Dari azure-spring-integration-storage-queue ke spring-integration-azure-storage-queue
• Dari azure-spring-cloud-stream-binder-eventhubs ke spring-cloud-azure-stream-binder-eventhubs
• Dari azure-spring-cloud-stream-binder-servicebus-* ke spring-cloud-azure-stream-binder-servicebus

Perubahan pustaka

Perubahan yang melanggar di setiap pustaka diperkenalkan sebagai berikut.

Dari azure-spring-boot-starter ke spring-cloud-azure-starter

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter dari versi 3 dari azure-spring-boot-starter.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan dependensi

Beberapa dependensi yang tidak perlu disertakan dalam artefak warisan, yang telah kami hapus di pustaka Spring Cloud Azure 4.0 modern. Pastikan untuk menambahkan dependensi yang dihapus secara manual ke proyek Anda untuk mencegah crash yang tidak disengaja.

Tabel berikut ini memperlihatkan dependensi Dihapus:

Dari azure-spring-boot-starter-active-directory ke spring-cloud-azure-starter-active-directory

Panduan ini dimaksudkan untuk membantu migrasi ke spring-cloud-azure-starter-active-directory dari versi 3 dari azure-spring-boot-starter-active-directory.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan dependensi

Beberapa dependensi yang tidak perlu dalam artefak warisan telah dihapus sejak pustaka Spring Cloud Azure 4.0 modern. Tambahkan dependensi yang dihapus ini ke proyek Anda untuk mencegah crash yang tidak disengaja.

Tabel berikut ini memperlihatkan dependensi Dihapus:

Perubahan konfigurasi SDK

Bagian ini mencakup perubahan tentang properti yang ditambahkan, dihapus, dan diubah.

• Dua poin berikut adalah yang utama untuk diperhatikan:

1. Semua awalan nama properti konfigurasi diubah dari azure.activedirectory ke spring.cloud.azure.active-directory.
2. Properti baru spring.cloud.azure.active-directory.enabled ditambahkan untuk mengaktifkan/menonaktifkan fitur terkait Microsoft Entra. Nilai defaultnya adalah false.

Tabel berikut ini memperlihatkan pemetaan properti antara azure-spring-boot-starter-active-directory dan spring-cloud-azure-starter-active-directory:

• Jenis nilai properti berikut diubah dari long menjadi Duration:

  • jwt-connect-timeout
  • jwt-read-timeout
  • jwk-set-cache-lifespan
  • jwk-set-cache-refresh-time.

• Properti berikut dihapus:

  • azure.activedirectory.allow-telemetry
  • azure.activedirectory.user-group.enable-full-list
  • azure.activedirectory.graph-base-uri
  • azure.activedirectory.graph-membership-uri

• Properti berikut ditambahkan:

  • spring.cloud.azure.active-directory.enabled
  • spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint
  • spring.cloud.azure.active-directory.user-group.use-transitive-members

Berikut adalah beberapa contoh migrasi:

• Contoh 1. Kasus 1

  • Untuk warisan: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/memberOf

  • Untuk modern: spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint=https://graph.microsoft.com/ + spring.cloud.azure.active-directory.user-group.use-transitive-members=false

• Contoh 2. Kasus 2

  • Untuk warisan: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/transitiveMemberOf

  • Untuk modern: spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint=https://graph.microsoft.com/ + spring.cloud.azure.active-directory.user-group.use-transitive-members=true

Perubahan API

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-boot-starter-active-directory ke spring-cloud-azure-starter-active-directory:

Bagian ini mencantumkan kelas yang dihapus dari azure-spring-boot-starter-active-directory.

• Menghapus kelas warisan

  • com.azure.spring.aad.webapp.AADHandleConditionalAccessFilter
  • com.azure.spring.aad.webapi.validator.AADJwtAudienceValidator
  • com.azure.spring.aad.webapi.validator.AADJwtClaimValidator

Dari azure-spring-boot-starter-active-directory-b2c ke spring-cloud-azure-starter-active-directory-b2c

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-active-directory-b2c dari versi 3 dari azure-spring-boot-starter-active-directory-b2c.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan dependensi

Beberapa dependensi yang tidak perlu disertakan dalam artefak warisan, yang telah kami hapus di pustaka Spring Cloud Azure 4.0 modern. Pastikan untuk menambahkan dependensi yang dihapus secara manual ke proyek Anda untuk mencegah crash yang tidak disengaja.

Tabel berikut ini memperlihatkan dependensi Dihapus:

Perubahan konfigurasi SDK

Bagian ini mencakup perubahan tentang properti yang ditambahkan, dihapus, dan diubah.

• Dua poin berikut adalah yang utama untuk diperhatikan:

1. Semua nama properti konfigurasi mengubah awalan dari azure.activedirectory.b2c menjadi spring.cloud.azure.active-directory.b2c.
2. Properti baru spring.cloud.azure.active-directory.b2c.enabled ditambahkan untuk memungkinkan mengaktifkan/menonaktifkan fitur terkait Azure AD B2C. Nilai defaultnya adalah false.

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-boot-starter-active-directory-b2c ke spring-cloud-azure-starter-active-directory-b2c:

• Properti yang dihapus dari azure-spring-boot-starter-active-directory-b2c:

  • azure.activedirectory.b2c.allow-telemetry
  • azure.activedirectory.b2c.tenant

• Jenis nilai properti berikut diubah dari long menjadi Duration:

  • jwt-connect-timeout
  • jwt-read-timeout

Perubahan API

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-boot-starter-active-directory-b2c ke spring-cloud-azure-starter-active-directory-b2c:

Dari azure-spring-boot-starter-cosmos ke spring-cloud-azure-starter-data-cosmos

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-data-cosmos dari versi 3 dari azure-spring-boot-starter-cosmos.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Semua nama properti konfigurasi mengubah awalan dari azure.cosmos menjadi spring.cloud.azure.cosmos.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-boot-starter-cosmos ke spring-cloud-azure-starter-data-cosmos:

Dari azure-spring-boot-starter-keyvault-secrets ke spring-cloud-azure-starter-keyvault-secrets

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-keyvault-secrets dari versi 3 dari azure-spring-boot-starter-keyvault-secrets.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Bagian ini mencakup perubahan tentang properti yang ditambahkan, dihapus, dan diubah.

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-boot-starter-keyvault-secrets ke spring-cloud-azure-starter-keyvault-secrets:

• Properti yang dihapus dari spring-cloud-azure-starter-keyvault-secrets:

  • azure.keyvault.allow-telemetry
  • azure.keyvault.order

Poin-poin berikut yang harus Anda perhatikan:

1. Semua nama properti konfigurasi mengubah awalan dari azure.keyvault menjadi spring.cloud.azure.keyvault.secret.
2. spring.cloud.azure.keyvault.secret.enabled digunakan untuk mengaktifkan semua fitur Rahasia Key Vault, termasuk mengonfigurasi Key Vault biji klien rahasia (seperti SecretClient dan SecretAsyncClient) dan menambahkan KeyVaultPropertySource di ConfigurableEnvironment.
3. spring.cloud.azure.keyvault.secret.property-source-enabled digunakan untuk mengaktifkan semua KeyVaultPropertySource. Ini akan berlaku hanya ketika spring.cloud.azure.keyvault.secret.enabled=true.
4. Untuk properti umum Azure(seperti client, proxy, retry, credential, profile) dan properti Key Vault(seperti properti endpoint, service-version). Jika spring.cloud.azure.keyvault.secret.property-sources[n].PROPERTY_NAME tidak dikonfigurasi, spring.cloud.azure.keyvault.secret.PROPERTY_NAME akan digunakan.
5. spring.cloud.azure.keyvault.secret.property-sources[n].resource khusus untuk sumber daya Azure unik, jadi jika tidak dikonfigurasi, sumber daya tersebut tidak akan mendapatkan nilai dari tempat lain.

Dari azure-spring-boot-starter-servicebus-jms ke spring-cloud-azure-starter-servicebus-jms

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-servicebus-jms dari versi 3 dari azure-spring-boot-starter-servicebus-jms.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Jenis konfigurasi untuk spring.jms.servicebus.idle-timeout diubah dari long (milidetik) ke Duration pola untuk keterbacaan.

Dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-blob

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-storage-blob dari versi 3 dari azure-spring-boot-starter-storage.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Semua nama properti konfigurasi mengubah awalan dari azure.storage menjadi spring.cloud.azure.storage.blob.

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-blob:

Perubahan API

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-blob:

Dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-file-share

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-storage-file-share dari versi 3 dari azure-spring-boot-starter-storage.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Semua nama properti konfigurasi mengubah awalan dari azure.storage menjadi spring.cloud.azure.storage.fileshare.

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-file-share:

Perubahan API

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-boot-starter-storage ke spring-cloud-azure-starter-storage-file-share:

Dari azure-spring-cloud-starter-eventhubs ke spring-cloud-azure-starter-integration-eventhubs

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-integration-eventhubs dari versi 2 dari azure-spring-cloud-starter-eventhubs.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Untuk perubahan entri anak untuk awalan ini, lihat tabel berikut:

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-cloud-starter-eventhubs ke spring-cloud-azure-starter-integration-eventhubs:

Misalnya, ubah dari:

spring:
  cloud:
    azure:
      eventhub:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        checkpoint-storage-account: ${AZURE_CHECKPOINT_STORAGE_ACCOUNT_NAME}
        checkpoint-access-key: ${AZURE_CHECKPOINT_ACCOUNT_KEY}
        checkpoint-container: ${AZURE_CHECKPOINT_CONTAINER_NAME}

ke:

spring:
  cloud:
    azure:
      eventhubs:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        processor:
          checkpoint-store:
            container-name: ${AZURE_STORAGE_CONTAINER_NAME}
            account-name: ${AZURE_STORAGE_ACCOUNT_NAME}
            account-key: ${AZURE_STORAGE_ACCOUNT_KEY}

Perubahan API

• Untuk perubahan pada anotasi pendengar, lihat panduan migrasi pustaka<< migrasi >>-azure-spring-cloud-messaging, azure-spring-cloud-messaging.
• Jatuhkan EventHubOperation dengan fungsi berlangganan dipindahkan ke EventHubsMessageListenerContainer kelas dan fungsi pengiriman dipindahkan ke EventHubsTemplate.
• Ganti nama EventHubInboundChannelAdapter sebagai EventHubsInboundChannelAdapter agar tetap konsisten dengan layanan Azure Event Hubs.
• Ubah konstruktor dari EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String) menjadi EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer) dan EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode).
• Ubah gaya instansiasi CheckpointConfig ke konstruktor sederhana alih-alih gaya build.
• Hilangkan API EventHubOperation#setCheckpointConfig. Untuk mengatur konfigurasi titik pemeriksaan untuk adaptor saluran masuk, pengguna dapat memanggil metode EventHubsContainerProperties#setCheckpointConfig.
• Hilangkan API EventHubOperation#setBatchConsumerConfig. Untuk mengatur konfigurasi yang menggunakan batch untuk adaptor saluran masuk, pengguna dapat memanggil dua metode EventHubsContainerProperties#getBatch#setMaxSize dan EventHubsContainerProperties#getBatch#setMaxWaitTime sementara itu.
• Untuk mode penggunaan batch, ubah nama header pesan yang dikonversi dari pesan batch.
  • Ubah header pesan dari azure_eventhub_enqueued_time menjadi azure_eventhubs_batch_converted_enqueued_time.
  • Ubah header pesan dari azure_eventhub_offset menjadi azure_eventhubs_batch_converted_offset.
  • Ubah header pesan dari azure_eventhub_sequence_number menjadi azure_eventhubs_batch_converted_sequence_number.
  • Ubah header pesan dari azure_partition_key menjadi azure_batch_converted_partition_key.
• Saat menerbitkan pesan ke Azure Event Hubs, abaikan semua header pesan yang dikonversi dari pesan batch. Header meliputi:
  • azure_batch_converted_partition_key
  • azure_eventhubs_batch_converted_enqueued_time
  • azure_eventhubs_batch_converted_offset
  • azure_eventhubs_batch_converted_sequence_number
  • azure_eventhubs_batch_converted_system_properties
  • azure_eventhubs_batch_converted_application_properties
• Mode titik pemeriksaan BATCH hanya berfungsi dalam mode penggunaan batch sekarang, yang dapat diaktifkan dengan meneruskan ListenerMode.BATCH ke konstruktor EventHubsInboundChannelAdapter.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-cloud-starter-eventhubs ke spring-cloud-azure-starter-integration-eventhubs:

Cuplikan kode sampel

• EventHubsInboundChannelAdapter kode sampel:

  Kode warisan:

  public class Demo {
      @Bean
      public EventHubInboundChannelAdapter messageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel, EventHubOperation   eventhubOperation) {
          eventhubOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode  (CheckpointMode.MANUAL).build());
          EventHubInboundChannelAdapter adapter = new EventHubInboundChannelAdapter("EVENTHUB_NAME",
              eventhubOperation, "CONSUMER_GROUP");
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

  Kode modern:

  public class Demo {
      @Bean
      public EventHubsMessageListenerContainer messageListenerContainer(EventHubsProcessorFactory processorFactory) {
          EventHubsContainerProperties containerProperties = new EventHubsContainerProperties();
          containerProperties.setEventHubName("EVENTHUB_NAME");
          containerProperties.setConsumerGroup("CONSUMER_GROUP");
          CheckpointConfig config = new CheckpointConfig(CheckpointMode.MANUAL);
          containerProperties.setCheckpointConfig(config);
          return new EventHubsMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public EventHubsInboundChannelAdapter messageChannelAdapter(@Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
                                                                  EventHubsMessageListenerContainer listenerContainer) {
          EventHubsInboundChannelAdapter adapter = new EventHubsInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

• DefaultMessageHandler kode sampel:

  Kode warisan:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL")
      public MessageHandler messageSender(EventHubOperation eventhubOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("EVENTHUB_NAME", eventhubOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.error("There was an error sending the message.", ex);
              }
          });
          return handler;
      }
  }
  

  Kode modern:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL")
      public MessageHandler messageSender(EventHubsTemplate eventhubOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("EVENTHUB_NAME", eventhubOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.error("There was an error sending the message.", ex);
              }
          });
  
          return handler;
      }
  }
  

Dari azure-spring-integration-eventhubs ke spring-integration-azure-eventhubs

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-integration-azure-eventhubs dari versi 2 dari azure-spring-integration-eventhubs.

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.

Perubahan API

• Jatuhkan EventHubOperation dengan fungsi berlangganan dipindahkan ke EventHubsMessageListenerContainer kelas dan fungsi pengiriman dipindahkan ke EventHubsTemplate.
• Ganti nama EventHubInboundChannelAdapter sebagai EventHubsInboundChannelAdapter agar tetap konsisten dengan layanan Azure Event Hubs.
• Ubah konstruktor dari EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String) menjadi EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer) dan EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode).
• Ubah gaya instansiasi CheckpointConfig ke konstruktor sederhana alih-alih gaya build.
• Hilangkan API EventHubOperation#setCheckpointConfig. Untuk mengatur konfigurasi titik pemeriksaan untuk adaptor saluran masuk, pengguna dapat memanggil metode EventHubsContainerProperties#setCheckpointConfig.
• Hilangkan API EventHubOperation#setBatchConsumerConfig. Untuk mengatur konfigurasi yang menggunakan batch untuk adaptor saluran masuk, pengguna dapat memanggil dua metode EventHubsContainerProperties#getBatch#setMaxSize dan EventHubsContainerProperties#getBatch#setMaxWaitTime sementara itu.
• Untuk mode penggunaan batch, ubah nama header pesan yang dikonversi dari pesan batch.
  • Ubah header pesan dari azure_eventhub_enqueued_time menjadi azure_eventhubs_batch_converted_enqueued_time.
  • Ubah header pesan dari azure_eventhub_offset menjadi azure_eventhubs_batch_converted_offset.
  • Ubah header pesan dari azure_eventhub_sequence_number menjadi azure_eventhubs_batch_converted_sequence_number.
  • Ubah header pesan dari azure_partition_key menjadi azure_batch_converted_partition_key.
• Saat menerbitkan pesan ke Azure Event Hubs, abaikan semua header pesan yang dikonversi dari pesan batch. Header meliputi:
  • azure_batch_converted_partition_key
  • azure_eventhubs_batch_converted_enqueued_time
  • azure_eventhubs_batch_converted_offset
  • azure_eventhubs_batch_converted_sequence_number
  • azure_eventhubs_batch_converted_system_properties
  • azure_eventhubs_batch_converted_application_properties
• Mode titik pemeriksaan BATCH hanya berfungsi dalam mode penggunaan batch sekarang, yang dapat diaktifkan dengan meneruskan ListenerMode.BATCH ke konstruktor EventHubsInboundChannelAdapter.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-integration-eventhubs ke spring-integration-azure-eventhubs:

Dari azure-spring-cloud-starter-servicebus ke spring-cloud-azure-starter-integration-servicebus

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-integration-servicebus dari versi 2 dari azure-spring-cloud-starter-servicebus.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Untuk semua opsi konfigurasi yang didukung di spring-cloud-azure-starter-integration-servicebus, awalan tetap sebagai spring.cloud.azure.servicebus.

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-cloud-starter-servicebus ke spring-cloud-azure-starter-integration-servicebus:

Perubahan API

• Jatuhkan ServiceBusQueueOperation dan ServiceBusTopicOperation dengan fungsi berlangganan dipindahkan ke ServiceBusMessageListenerContainer kelas dan fungsi pengiriman dipindahkan ke ServiceBusTemplate.
• Jatuhkan ServiceBusQueueInboundChannelAdapter dan ServiceBusTopicInboundChannelAdapter, dan pindahkan fungsionalitas untuk mendengarkan entitas antrean/topik Bus Layanan ke ServiceBusInboundChannelAdapter.
• Ubah konstruktor dari ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String) menjadi ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) dan ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Ubah konstruktor dari ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String) menjadi ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) dan ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Hilangkan API ServiceBusQueueOperation#setCheckpointConfig dan ServiceBusTopicOperation#setCheckpointConfig. Untuk mengatur konfigurasi titik pemeriksaan untuk adaptor saluran masuk, pengguna dapat memanggil metode ServiceBusContainerProperties#setAutoComplete sebagai gantinya. Untuk menonaktifkan mode lengkapi otomatis setara dengan mode titik pemeriksaan MANUAL dan untuk mengaktifkannya akan memicu mode RECORD.
• Hilangkan API ServiceBusQueueOperatio#setClientConfig dan ServiceBusTopicOperation#setClientConfig. Untuk mengonfigurasi ServiceBusProcessorClient yang mendasar yang digunakan oleh adaptor saluran masuk, pengguna dapat menggunakan ServiceBusContainerProperties sebagai gantinya.
• Hilangkan dukungan CompletableFuture di ServiceBusTemplate dan DefaultMessageHandler, dukung Reactor sebagai gantinya.
• Tambahkan API baru ServiceBusTemplate#setDefaultEntityType untuk menentukan jenis entitas, yang diperlukan ketika tidak ada kacang PropertiesSupplier<String, ProducerProperties> yang disediakan untuk ProducerProperties#entityType.
• Jatuhkan header pesan AzureHeaders.RAW_ID. Gunakan ServiceBusMessageHeaders.MESSAGE_ID sebagai gantinya.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-cloud-starter-servicebus ke spring-cloud-azure-starter-integration-servicebus:

Cuplikan kode sampel

• ServiceBusInboundChannelAdapter kode sampel:

  Kode warisan menggunakan ServiceBusQueueInboundChannelAdapter atau ServiceBusTopicInboundChannelAdapter:

  public class Demo {
      @Bean
      public ServiceBusQueueInboundChannelAdapter queueMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL_NAME") MessageChannel inputChannel, ServiceBusQueueOperation queueOperation) {
          queueOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode(CheckpointMode.MANUAL).build());
          ServiceBusQueueInboundChannelAdapter adapter = new ServiceBusQueueInboundChannelAdapter("QUEUE_NAME",
              queueOperation);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
      @Bean
      public ServiceBusTopicInboundChannelAdapter topicMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL_NAME") MessageChannel inputChannel, ServiceBusTopicOperation topicOperation) {
          topicOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode(CheckpointMode.MANUAL).build());
          ServiceBusTopicInboundChannelAdapter adapter = new ServiceBusTopicInboundChannelAdapter("TOPIC_NAME",
              topicOperation, "SUBSCRIPTION_NAME");
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
  }
  

  Kode modern:

  public class Demo {
      @Bean("queue-listener-container")
      public ServiceBusMessageListenerContainer messageListenerContainer(ServiceBusProcessorFactory processorFactory) {
          ServiceBusContainerProperties containerProperties = new ServiceBusContainerProperties();
          containerProperties.setEntityName("QUEUE_NAME");
          containerProperties.setAutoComplete(false);
          return new ServiceBusMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public ServiceBusInboundChannelAdapter queueMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
          @Qualifier("queue-listener-container") ServiceBusMessageListenerContainer listenerContainer) {
          ServiceBusInboundChannelAdapter adapter = new ServiceBusInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
      @Bean("topic-listener-container")
      public ServiceBusMessageListenerContainer messageListenerContainer(ServiceBusProcessorFactory processorFactory) {
          ServiceBusContainerProperties containerProperties = new ServiceBusContainerProperties();
          containerProperties.setEntityName("TOPIC_NAME");
          containerProperties.setSubscriptionName("SUBSCRIPTION_NAME");
          containerProperties.setAutoComplete(false);
          return new ServiceBusMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public ServiceBusInboundChannelAdapter topicMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
          @Qualifier("topic-listener-container") ServiceBusMessageListenerContainer listenerContainer) {
          ServiceBusInboundChannelAdapter adapter = new ServiceBusInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

• DefaultMessageHandler kode sampel:

  Kode warisan, mengambil antrean sebagai contoh:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL_NAME")
      public MessageHandler queueMessageSender(ServiceBusQueueOperation queueOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("QUEUE_NAME", queueOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.info("There was an error sending the message.");
              }
          });
          return handler;
      }
  }
  

  Kode modern:

  public class Demo {
  
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL_NAME")
      public MessageHandler queueMessageSender(ServiceBusTemplate serviceBusTemplate) {
          serviceBusTemplate.setDefaultEntityType(ServiceBusEntityType.QUEUE);
          DefaultMessageHandler handler = new DefaultMessageHandler("QUEUE_NAME", serviceBusTemplate);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully for {}.", "QUEUE_NAME");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.info("There was an error sending the message.");
              }
          });
  
          return handler;
      }
  }
  

Dari azure-spring-integration-servicebus ke spring-integration-azure-servicebus

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-integration-azure-servicebus dari versi 2 dari azure-spring-integration-servicebus.

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.

Perubahan API

• Jatuhkan ServiceBusQueueOperation dan ServiceBusTopicOperation dengan fungsi berlangganan dipindahkan ke ServiceBusMessageListenerContainer kelas dan fungsi pengiriman dipindahkan ke ServiceBusTemplate.
• Jatuhkan ServiceBusQueueInboundChannelAdapter dan ServiceBusTopicInboundChannelAdapter, dan pindahkan fungsionalitas untuk mendengarkan entitas antrean/topik Bus Layanan ke ServiceBusInboundChannelAdapter.
• Ubah konstruktor dari ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String) menjadi ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) dan ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Ubah konstruktor dari ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String) menjadi ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) dan ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Hilangkan API ServiceBusQueueOperation#setCheckpointConfig dan ServiceBusTopicOperation#setCheckpointConfig. Untuk mengatur konfigurasi titik pemeriksaan untuk adaptor saluran masuk, pengguna dapat memanggil metode ServiceBusContainerProperties#setAutoComplete sebagai gantinya. Untuk menonaktifkan mode lengkapi otomatis setara dengan mode titik pemeriksaan MANUAL dan untuk mengaktifkannya akan memicu mode RECORD.
• Hilangkan API ServiceBusQueueOperation#setClientConfig dan ServiceBusTopicOperation#setClientConfig. Untuk mengonfigurasi ServiceBusProcessorClient yang mendasar yang digunakan oleh adaptor saluran masuk, pengguna dapat menggunakan ServiceBusContainerProperties sebagai gantinya.
• Hilangkan dukungan CompletableFuture di ServiceBusTemplate dan DefaultMessageHandler, dukung Reactor sebagai gantinya.
• Tambahkan API baru ServiceBusTemplate#setDefaultEntityType untuk menentukan jenis entitas, yang diperlukan ketika tidak ada kacang PropertiesSupplier<String, ProducerProperties> yang disediakan untuk ProducerProperties#entityType.
• Jatuhkan header pesan AzureHeaders.RAW_ID. Gunakan ServiceBusMessageHeaders.MESSAGE_ID sebagai gantinya.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-integration-servicebus ke spring-integration-azure-servicebus:

Dari azure-spring-cloud-starter-storage-queue ke spring-cloud-azure-starter-integration-storage-queue

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-starter-integration-storage-queue dari versi 2 dari azure-spring-cloud-starter-storage-queue.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Semua nama properti konfigurasi mengubah awalan dari spring.cloud.azure.storage menjadi spring.cloud.azure.storage.queue.

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-cloud-starter-storage-queue ke spring-cloud-azure-starter-integration-storage-queue:

Perubahan API

• Hilangkan StorageQueueOperation dan berikan StorageQueueTemplate sebagai gantinya.
• Hilangkan konfigurasi checkpoint-mode di StorageQueueTemplate, hanya mendukung mode MANUAL.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-cloud-starter-storage-queue ke spring-cloud-azure-starter-integration-storage-queue.

Dari azure-spring-integration-storage-queue ke spring-integration-azure-storage-queue

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-integration-azure-storage-queue dari versi 2 dari azure-spring-integration-storage-queue.

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.

Perubahan API

• Hilangkan StorageQueueOperation dan berikan StorageQueueTemplate sebagai gantinya.
• Hilangkan konfigurasi checkpoint-mode di StorageQueueTemplate, hanya mendukung mode MANUAL.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-integration-storage-queue ke spring-integration-azure-storage-queue.

Dari azure-spring-cloud-stream-binder-eventhubs ke spring-cloud-azure-stream-binder-eventhubs

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-stream-binder-eventhubs dari versi 2 dari azure-spring-cloud-stream-binder-eventhubs.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Untuk perubahan entri anak untuk awalan berikut, lihat tabel berikut ini.

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-cloud-stream-binder-eventhubs ke spring-cloud-azure-stream-binder-eventhubs:

Contoh migrasi konfigurasi

Untuk menggunakan string koneksi untuk autentikasi dan memigrasikan properti yang disebutkan di atas, perubahan konfigurasi dicantumkan sebagai berikut:

Konfigurasi warisan:

spring:
  cloud:
    azure:
      eventhub:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        checkpoint-storage-account: ${AZURE_CHECKPOINT_STORAGE_ACCOUNT_NAME}
        checkpoint-access-key: ${AZURE_CHECKPOINT_ACCOUNT_KEY}
        checkpoint-container: ${AZURE_CHECKPOINT_CONTAINER_NAME}
    stream:
      eventhub:
        bindings:
          <binding-name>:
            consumer:
              max-batch-size: ${AZURE_MAX_BATCH_SIZE}
              max-wait-time: ${AZURE_MAX_WAIT_TIME}
              checkpoint-mode: ${AZURE_CHECKPOINT_MODE}
              checkpoint-count: ${AZURE_CHECKPOINT_COUNT}
              checkpoint-interval: ${AZURE_CHECKPOINT_INTERVAL}
              start-position: EARLIEST

Konfigurasi modern:

spring:
  cloud:
    azure:
      eventhubs:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        processor:
          checkpoint-store:
            container-name: ${AZURE_STORAGE_CONTAINER_NAME}
            account-name:  ${AZURE_STORAGE_ACCOUNT_NAME}
            account-key: ${AZURE_STORAGE_ACCOUNT_KEY}
    stream:
      eventhubs:
        bindings:
          <binding-name>:
            consumer:
              batch:
                max-size: ${AZURE_MAX_BATCH_SIZE}
                max-wait-time: ${AZURE_MAX_WAIT_TIME}
              checkpoint:
                mode: ${AZURE_CHECKPOINT_MODE}
                count: ${AZURE_CHECKPOINT_COUNT}
                interval: ${AZURE_CHECKPOINT_INTERVAL}
              initial-partition-event-position:
                0:
                  offset: earliest
                1:
                  sequence-number: 100
                2:
                  enqueued-date-time: 2022-01-12T13:32:47.650005Z
                4:
                  inclusive: false

Jika Anda menggunakan prinsip keamanan alih-alih string koneksi, dalam versi sebelum 4.0 aplikasi pertama-tama akan terhubung ke Azure Resource Manager (ARM) dengan prinsip keamanan yang disediakan, lalu mengambil string koneksi namespace yang ditentukan dengan ARM. Pada akhirnya aplikasi menggunakan string koneksi yang diambil untuk terhubung ke Azure Event Hubs. Dengan cara ini, prinsip keamanan yang disediakan harus diberikan dengan peran Contributor untuk mengambil namespace Azure Event Hubs terkait.

Untuk Azure Spring Apps 4.0, kami menyediakan dua cara untuk memanfaatkan prinsip keamanan untuk autentikasi. Seseorang masih menggunakan prinsipal untuk terhubung ke ARM dan mengambil string koneksi di mana peran Contributor diperlukan untuk prinsipal. Yang lain memanfaatkan prinsip keamanan untuk mengautentikasi ke Microsoft Entra ID dan kemudian terhubung ke Azure Event Hubs secara langsung. Dalam hal ini, peran Contributor tidak diperlukan lagi, sementara peran terkait Data lainnya diperlukan untuk operasi olahpesan. Untuk memastikan prinsip keamanan telah diberikan izin yang memadai untuk mengakses sumber daya Azure, lihat Authorize akses dengan Microsoft Entra ID.

Untuk autentikasi berdasarkan ARM, mengambil perwakilan layanan sebagai contoh, migrasi konfigurasi tercantum sebagai berikut, di mana peran yang ditetapkan tidak boleh berubah:

Konfigurasi warisan:

spring:
  cloud:
    azure:
      client-id: ${AZURE_CLIENT_ID}
      client-secret: ${AZURE_CLIENT_SECRET}
      tenant-id: <tenant>
      resource-group: ${EVENTHUB_RESOURCE_GROUP}
      eventhub:
        namespace: ${EVENTHUB_NAMESPACE}

Konfigurasi modern, properti untuk ID langganan Azure dan grup sumber daya diperlukan:

spring:
  cloud:
    azure:
      credential:
        client-id: ${AZURE_CLIENT_ID}
        client-secret: ${AZURE_CLIENT_SECRET}
      profile:
        tenant-id: <tenant>
        subscription-id: ${AZURE_SUBSCRIPTION_ID}
      eventhubs:
        namespace: ${EVENTHUB_NAMESPACE}
        resource:
          resource-group: ${RESOURCE_GROUP}

Anda juga dapat bermigrasi untuk mengautentikasi dan mengotorisasi dengan Microsoft Entra ID secara langsung tanpa melakukan memutar ke ARM. Pastikan untuk memberikan peran Data yang diperlukan perwakilan keamanan untuk operasi olahpesan. Contoh konfigurasi perwakilan layanan dan identitas terkelola tercantum sebagai berikut:

• Dengan perwakilan layanan

  spring:
    cloud:
      azure:
        credential:
          client-id: ${AZURE_CLIENT_ID}
          client-secret: ${AZURE_CLIENT_SECRET}
        profile:
          tenant-id: <tenant>
        eventhubs:
          namespace: ${EVENTHUB_NAMESPACE}
  

• Dengan identitas terkelola

  spring:
    cloud:
      azure:
        credential:
          managed-identity-enabled: true
          client-id: ${AZURE_MANAGED_IDENTITY_CLIENT_ID} # Only needed when using a user-assigned managed identity
        eventhubs:
          namespace: ${EVENTHUB_NAMESPACE}
  

Perubahan API

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-cloud-stream-binder-eventhubs ke spring-cloud-azure-stream-binder-eventhubs.

Dari azure-spring-cloud-stream-binder-servicebus-* ke spring-cloud-azure-stream-binder-servicebus

Panduan ini dimaksudkan untuk membantu dalam migrasi ke spring-cloud-azure-stream-binder-servicebus dari versi 2 atau azure-spring-cloud-stream-binder-servicebus-queueazure-spring-cloud-stream-binder-servicebus-topic.

Untuk informasi umum, gunakan tautan berikut:

• Untuk gambaran umum perubahan di 4.0, lihat bagian Pengenalan dan Migrasi.
• Untuk mempelajari selengkapnya tentang perubahan strategi dalam penamaan proyek, lihat bagian perubahan penamaan .
• Untuk mempelajari cara menggunakan satu BOM untuk semua pustaka Azure Spring Cloud, lihat bagian BOM.
• Untuk mempelajari cara menangani autentikasi di Spring Cloud Azure 4.0, lihat bagian perubahan Autentikasi.
• Untuk mempelajari cara memanfaatkan spring-boot-properties-migrator selama migrasi, lihat bagian Mengonfigurasi setiap SDK.
• Untuk mempelajari selengkapnya tentang perubahan konfigurasi global dan umum, lihat bagian konfigurasi global .

Perubahan konfigurasi SDK

Tabel berikut mencantumkan properti konfigurasi baru spring-cloud-azure-stream-binder-servicebus:

Tabel berikut ini memperlihatkan pemetaan properti dari azure-spring-cloud-stream-binder-servicebus-* ke spring-cloud-azure-stream-binder-servicebus:

Contoh migrasi konfigurasi

Konfigurasi warisan, mengambil antrean sebagai contoh:

spring:
  cloud:
    azure:
      servicebus:
        connection-string: ${AZURE_SERVICEBUS_BINDER_CONNECTION_STRING}
    stream:
      function:
        definition: consume;supply
      bindings:
        consume-in-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
        supply-out-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
      servicebus:
        queue:
          bindings:
            consume-in-0:
              consumer:
                checkpoint-mode: MANUAL

Konfigurasi modern:

spring:
  cloud:
    azure:
      servicebus:
        connection-string: ${AZURE_SERVICEBUS_BINDER_CONNECTION_STRING}
    stream:
      function:
        definition: consume;supply
      bindings:
        consume-in-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
        supply-out-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
      servicebus:
        bindings:
          consume-in-0:
            consumer:
              auto-complete: false
          supply-out-0:
            producer:
              entity-type: queue #set as topic if needed

Jika Anda menggunakan prinsip keamanan alih-alih string koneksi, dalam versi sebelum 4.0 aplikasi pertama-tama akan terhubung ke Azure Resource Manager (ARM) dengan prinsip keamanan yang disediakan, lalu mengambil string koneksi namespace yang ditentukan dengan ARM. Pada akhirnya aplikasi menggunakan string koneksi yang diambil untuk terhubung ke Azure Service Bus. Dengan cara ini, prinsip keamanan yang disediakan harus diberikan dengan peran Contributor untuk mengambil namespace Azure Service Bus terkait.

Untuk Azure Spring Apps 4.0, kami menyediakan dua cara untuk memanfaatkan prinsip keamanan untuk autentikasi. Seseorang masih menggunakan prinsipal untuk terhubung ke ARM dan mengambil string koneksi di mana peran Contributor diperlukan untuk prinsipal. Yang lain memanfaatkan prinsip keamanan untuk mengautentikasi ke Microsoft Entra ID dan kemudian terhubung ke Azure Service Bus secara langsung. Dalam hal ini, peran Contributor tidak diperlukan lagi, sementara peran terkait Data lainnya diperlukan untuk operasi olahpesan. Untuk memastikan prinsip keamanan telah diberikan izin yang memadai untuk mengakses sumber daya Azure, lihat Authorize akses dengan Microsoft Entra ID.

Untuk autentikasi berdasarkan ARM, mengambil perwakilan layanan sebagai contoh, migrasi konfigurasi tercantum sebagai berikut, di mana peran yang ditetapkan tidak boleh berubah:

Konfigurasi warisan:

spring:
  cloud:
    azure:
      client-id: ${AZURE_CLIENT_ID}
      client-secret: ${AZURE_CLIENT_SECRET}
      tenant-id: <tenant>
      resource-group: ${SERVICEBUS_RESOURCE_GROUP}
      servicebus:
        namespace: ${SERVICEBUS_NAMESPACE}

Konfigurasi modern, properti untuk ID langganan Azure dan grup sumber daya diperlukan:

spring:
  cloud:
    azure:
      credential:
        client-id: ${AZURE_CLIENT_ID}
        client-secret: ${AZURE_CLIENT_SECRET}
      profile:
        tenant-id: <tenant>
        subscription-id: ${AZURE_SUBSCRIPTION_ID}
      servicebus:
        namespace: ${SERVICEBUS_NAMESPACE}
        resource:
          resource-group: ${SERVICEBUS_RESOURCE_GROUP}

Anda juga dapat bermigrasi untuk mengautentikasi dan mengotorisasi dengan Microsoft Entra ID secara langsung tanpa melakukan memutar ke ARM. Pastikan untuk memberikan peran Data yang diperlukan perwakilan keamanan untuk operasi olahpesan. Contoh konfigurasi perwakilan layanan dan identitas terkelola tercantum sebagai berikut:

• Dengan perwakilan layanan

  spring:
    cloud:
      azure:
        credential:
          client-id: ${AZURE_CLIENT_ID}
          client-secret: ${AZURE_CLIENT_SECRET}
        profile:
          tenant-id: <tenant>
        servicebus:
          namespace: ${SERVICEBUS_NAMESPACE}
  

• Dengan identitas terkelola

  spring:
    cloud:
      azure:
        credential:
          managed-identity-enabled: true
          client-id: ${AZURE_MANAGED_IDENTITY_CLIENT_ID} # Only needed when using a user-assigned   managed identity
        servicebus:
          namespace: ${SERVICEBUS_NAMESPACE}
  

Perubahan API

• Jatuhkan header pesan AzureHeaders.RAW_ID. Gunakan ServiceBusMessageHeaders.MESSAGE_ID sebagai gantinya.

Tabel berikut ini memperlihatkan pemetaan kelas dari azure-spring-cloud-stream-binder-eventhubs ke spring-cloud-azure-stream-binder-eventhubs.

azure-spring-cloud-messaging

Pustaka com.azure.spring:azure-spring-cloud-messaging belum siap untuk 4.0. Fungsi anotasi pendengar sedang didesain ulang, sehingga anotasi @AzureMessageListener, @AzureMessageListeners, dan @EnableAzureMessaging saat ini tidak didukung.