Guida alla migrazione per Spring Cloud Azure 4.0

Questa guida consente di eseguire la migrazione a Spring Cloud Azure 4.0 dalle librerie legacy Azure Spring.

Introduzione

Verranno chiamate librerie il cui ID gruppo e ID artefatto seguono il modello le librerie moderne e quelle con pattern , o le librerie legacy .

Questa guida si concentrerà sui confronti side-by-side per configurazioni simili tra le librerie moderne e legacy.

Si presuppone la familiarità con com.azure.spring:azure-spring-boot-*, com.azure.spring:azure-spring-cloud-* o pacchetto di com.azure.spring:azure-spring-integration-*.

Se non si ha familiarità con le librerie Spring Cloud Azure 4.0, vedere la guida per sviluppatori Spring Cloud Azure anziché questa guida.

Vantaggi della migrazione

Una domanda naturale da porre quando si valuta se adottare una nuova versione o libreria è il suo vantaggio. Man mano che Azure è maturo ed è stato abbracciato da un gruppo di sviluppatori più diversificato, ci siamo concentrati sull'apprendimento dei modelli e delle procedure per supportare al meglio la produttività degli sviluppatori e per comprendere le lacune presenti nelle librerie di Spring Cloud Azure.

Esistono diverse aree di feedback coerenti espresse nelle librerie spring cloud Azure. L'aspetto più importante è che le librerie per i diversi servizi di Azure non hanno abilitato il set completo di configurazioni. Inoltre, l'incoerenza della denominazione del progetto, gli ID artefatti, le versioni e le configurazioni hanno reso la curva di apprendimento ripida.

Per migliorare l'esperienza di sviluppo nelle librerie spring cloud Azure, è stato introdotto un set di linee guida per la progettazione per garantire che le librerie Spring Cloud Azure abbiano un'atmosfera naturale e idiotica rispetto all'ecosistema Spring. Altri dettagli sono disponibili nella documentazione design per gli interessati.

Spring Cloud Azure 4.0 offre l'esperienza condivisa tra librerie che si integrano con progetti Spring diversi, ad esempio Spring Boot, Spring Integration, Spring Cloud Stream e così via. L'esperienza condivisa include:

• Distinta base unificata per includere tutte le librerie Spring Cloud Azure 4.0.
• Convenzione di denominazione coerente per gli artefatti.
• Un modo unificato per configurare le credenziali, il proxy, i tentativi, l'ambiente cloud e le impostazioni del livello di trasporto.
• Supporto di tutti i metodi di autenticazione supportati da un servizio Azure o Azure Service SDK.

Panoramica

Questa guida alla migrazione è costituita dalle sezioni seguenti:

• Modifiche alla denominazione per Spring Cloud Azure 4.0
• Modifiche all'artefatto: rinominato/aggiunto/eliminato
• Modifiche alle dipendenze
• Modifiche all'autenticazione
• Proprietà di configurazione
• Modifiche che causano un'interruzione dell'API
• Modifiche alla libreria

Modifiche alla denominazione

Non c'è mai stato un nome ufficiale o coerente per chiamare tutte le librerie spring cloud Azure. Alcuni di essi sono stati chiamati Azure Spring Boot e alcuni di essi Spring on Azure. Dalla versione 4.0 è iniziato a usare il nome del progetto Spring Cloud Azure per rappresentare tutte le librerie Spring Azure.

DBA

È stato usato per spedire due MACCHINE virtuali per le librerie, la azure-spring-boot-bom e azure-spring-cloud-dependencies, ma queste due macchine virtuali sono state combinate in una distinta base a partire dalla 4.0, la spring-cloud-azure-dependencies. Aggiungere una voce nella sezione dependencyManagement del progetto per trarre vantaggio dalla gestione delle dipendenze.

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

Modifiche all'artefatto: rinominato/aggiunto/eliminato

Gli ID gruppo sono gli stessi per le librerie spring cloud moderne e legacy Azure. Sono tutti com.azure.spring. Gli ID degli artefatti per le moderne librerie di Azure Spring Cloud sono stati modificati. In base al progetto Spring a cui appartiene, Spring Boot, Spring Integration o Spring Cloud Stream, il modello di ID artefatto potrebbe essere spring-cloud-azure-starter-[service], spring-integration-azure-[service]o spring-cloud-azure-stream-binder-[service]. Gli starter legacy per ognuno hanno un ID artefatto che segue il modello azure-spring-*. Questo offre un mezzo rapido e accessibile per comprendere, a colpo d'occhio, sia che si usino starter moderni o legacy.

Nel processo di sviluppo di Spring Cloud Azure 4.0 sono stati rinominati alcuni artefatti per renderli conformi alle nuove convenzioni di denominazione, sono stati eliminati alcuni artefatti in modo che la funzionalità possa essere inserita in un artefatto più appropriato e sono stati aggiunti alcuni nuovi artefatti per gestire meglio alcuni scenari.

La tabella seguente illustra i mapping tra l'ID artefatto legacy e l'ID artefatto moderno:

Modifiche alle dipendenze

Alcune dipendenze non necessarie sono state incluse negli artefatti legacy, che sono state rimosse nelle moderne librerie Spring Cloud Azure 4.0. Assicurarsi di aggiungere manualmente le dipendenze rimosse al progetto per evitare arresti anomali.

Le librerie con modifiche alle dipendenze includono:

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

Modifiche all'autenticazione

Spring Cloud Azure 4.0 supporta tutti i metodi di autenticazione supportati da ogni Azure Service SDK. Consente di configurare le credenziali di un token globale e di fornire le credenziali del token a ogni livello di servizio. Tuttavia, non è necessario configurare Spring Cloud Azure 4.0 perché può applicare le credenziali archiviate in un ambiente di sviluppo locale o un'identità gestita in Azure Services. Assicurarsi che all'entità sia stata concessa un'autorizzazione sufficiente per accedere alle risorse di Azure di destinazione.

Una credenziale concatenata, la DefaultAzureCredential bean è configurata automaticamente per impostazione predefinita e verrà usata da tutti i componenti se non vengono specificate altre informazioni di autenticazione. Per altre informazioni, vedere la sezione DefaultAzureCredential della libreria client Azure Identity per Java.

Proprietà di configurazione

Migrazione delle proprietà

È stato creato un file additional-spring-configuration-metadata.json per uniformare la migrazione delle proprietà quando si usa con spring-boot-properties-migrator. Aggiungere prima di tutto la seguente proprietà migratrice all'applicazione:

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

In alternativa, se si usa Gradle:

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

Se si esegue l'app, verranno identificate le proprietà non più gestite da Spring Cloud Azure. Se è presente una sostituzione, verrà temporaneamente mappata la proprietà con un avviso. Se non è presente una sostituzione, verrà restituita una segnalazione errori. In entrambi i casi, la configurazione deve essere aggiornata e la dipendenza rimossa dopo aver aggiornato la configurazione.

Prima di procedere, è consigliabile usare la funzionalità di ricerca dell'IDE per verificare che non si usi una delle proprietà di cui è stata eseguita la migrazione in un test di integrazione.

Configurazioni globali

La < moderna /> consente di definire proprietà applicabili a tutte le Azure SDKs nello spazio dei nomi . Questa funzionalità non è supportata nell'azure-spring-boot-starterlegacy. Le configurazioni globali possono essere suddivise in cinque categorie, illustrate nella tabella seguente:

Per un elenco completo delle configurazioni, vedere Spring Cloud Azure proprietà di configurazione.

Configurare ogni SDK

Per informazioni dettagliate sulle opzioni di configurazione a livello di SDK, usare i collegamenti seguenti:

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

Modifiche che causano un'interruzione dell'API

Per informazioni dettagliate sulle modifiche di rilievo dell'API in ogni libreria, usare i collegamenti seguenti:

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

Modifiche alla libreria

Le modifiche di rilievo in ogni libreria vengono introdotte nel modo seguente.

Da azure-spring-boot-starter a spring-cloud-azure-starter

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter dalla versione 3 di azure-spring-boot-starter.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alle dipendenze

Alcune dipendenze non necessarie sono state incluse negli artefatti legacy, che sono state rimosse nelle moderne librerie Spring Cloud Azure 4.0. Assicurarsi di aggiungere manualmente le dipendenze rimosse al progetto per evitare arresti anomali involontari.

La tabella seguente illustra le dipendenze rimosse:

da azure-spring-boot-starter-active-directory a spring-cloud-azure-starter-active-directory

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-active-directory dalla versione 3 di azure-spring-boot-starter-active-directory.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alle dipendenze

Alcune dipendenze non necessarie nell'artefatto legacy sono state rimosse dopo la moderna libreria Spring Cloud Azure 4.0. Aggiungere queste dipendenze rimosse al progetto per evitare arresti anomali accidentali.

La tabella seguente illustra le dipendenze rimosse:

Modifiche alla configurazione dell'SDK

Questa sezione include le modifiche apportate alle proprietà aggiunte, rimosse e modificate.

• I due punti seguenti sono i principali per prestare attenzione a:

1. Il prefisso di tutti i nomi delle proprietà di configurazione è stato modificato da azure.activedirectory a spring.cloud.azure.active-directory.
2. Viene aggiunta la nuova proprietà spring.cloud.azure.active-directory.enabled per abilitare/disabilitare Microsoft Entra funzionalità correlate. Il valore predefinito è false.

Nella tabella seguente vengono illustrati i mapping delle proprietà tra azure-spring-boot-starter-active-directory e spring-cloud-azure-starter-active-directory:

• Il tipo di valore delle proprietà seguenti viene modificato da long a Duration:

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

• Vengono rimosse le proprietà seguenti:

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

• Vengono aggiunte le proprietà seguenti:

  • 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 (opzione per utilizzare membri transitivi nei gruppi utente)

Ecco alcuni esempi di migrazione:

• Esempio 1. Caso 1

  • Per la versione legacy: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/memberOf

  • Per la versione moderna: 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

• Esempio 2. Caso 2

  • Per la versione legacy: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/transitiveMemberOf

  • Per la versione moderna: 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

Modifiche api

La tabella seguente illustra i mapping delle classi da azure-spring-boot-starter-active-directory a spring-cloud-azure-starter-active-directory:

Questa sezione elenca le classi rimosse da azure-spring-boot-starter-active-directory.

• Classe legacy rimossa

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

da azure-spring-boot-starter-active-directory-b2c a spring-cloud-azure-starter-active-directory-b2c

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-active-directory-b2c dalla versione 3 di azure-spring-boot-starter-active-directory-b2c.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alle dipendenze

Alcune dipendenze non necessarie sono state incluse negli artefatti legacy, che sono state rimosse nelle moderne librerie Spring Cloud Azure 4.0. Assicurarsi di aggiungere manualmente le dipendenze rimosse al progetto per evitare arresti anomali involontari.

La tabella seguente illustra le dipendenze rimosse:

Modifiche alla configurazione dell'SDK

Questa sezione include le modifiche apportate alle proprietà aggiunte, rimosse e modificate.

• I due punti seguenti sono i principali per prestare attenzione a:

1. Tutti i nomi delle proprietà di configurazione hanno modificato il prefisso da azure.activedirectory.b2c a spring.cloud.azure.active-directory.b2c.
2. Viene aggiunta una nuova proprietà spring.cloud.azure.active-directory.b2c.enabled per consentire l'abilitazione/disabilitazione Azure funzionalità correlate ad AD B2C. Il valore predefinito è false.

La tabella seguente illustra i mapping delle proprietà da azure-spring-boot-starter-active-directory-b2c a spring-cloud-azure-starter-active-directory-b2c:

• Proprietà rimosse da azure-spring-boot-starter-active-directory-b2c:

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

• Il tipo di valore delle proprietà seguenti viene modificato da long a Duration:

  • jwt-connessione-timeout
  • jwt-read-timeout

Modifiche api

La tabella seguente illustra i mapping delle classi da azure-spring-boot-starter-active-directory-b2c a spring-cloud-azure-starter-active-directory-b2c:

da azure-spring-boot-starter-cosmos a spring-cloud-azure-starter-data-cosmos

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-data-cosmos dalla versione 3 di azure-spring-boot-starter-cosmos.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Tutti i nomi delle proprietà di configurazione hanno modificato il prefisso da azure.cosmos a spring.cloud.azure.cosmos.

La tabella seguente illustra i mapping delle classi da azure-spring-boot-starter-cosmos a spring-cloud-azure-starter-data-cosmos:

da azure-spring-boot-starter-keyvault-secrets a spring-cloud-starter-keyvault-secrets

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-keyvault-secrets dalla versione 3 di azure-spring-boot-starter-keyvault-secrets.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Questa sezione include le modifiche apportate alle proprietà aggiunte, rimosse e modificate.

La tabella seguente illustra i mapping delle proprietà da azure-spring-boot-starter-keyvault-secrets a spring-cloud-azure-starter-keyvault-secrets:

• Rimozione delle proprietà da spring-cloud-azure-starter-keyvault-secrets

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

I punti seguenti è consigliabile prestare attenzione a:

1. Tutti i nomi delle proprietà di configurazione hanno modificato il prefisso da azure.keyvault a spring.cloud.azure.keyvault.secret.
2. spring.cloud.azure.keyvault.secret.enabled viene usato per abilitare tutte le funzionalità del segreto Key Vault, includere la configurazione dei fagioli client segreti Key Vault(ad esempio SecretClient e SecretAsyncClient) e aggiungere KeyVaultPropertySource in ConfigurableEnvironment.
3. spring.cloud.azure.keyvault.secret.property-source-enabled viene usato per abilitare tutti i KeyVaultPropertySource. Avrà effetto solo quando spring.cloud.azure.keyvault.secret.enabled=true.
4. Per Azure proprietà comuni, ad esempio client, proxy, retry, credential, profile) e proprietà Key Vault(ad esempio endpoint, service-version). Se spring.cloud.azure.keyvault.secret.property-sources[n].PROPERTY_NAME non è configurato, verrà usato spring.cloud.azure.keyvault.secret.PROPERTY_NAME.
5. spring.cloud.azure.keyvault.secret.property-sources[n].resource è specifico di una risorsa Azure univoca, quindi, se non è configurata, non otterrà valore da altre posizioni.

da azure-spring-boot-starter-servicebus-jms a spring-cloud-azure-starter-servicebus-jms

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-servicebus-jms dalla versione 3 di azure-spring-boot-starter-servicebus-jms.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Tipo di configurazione per spring.jms.servicebus.idle-timeout modificato da long(millisecondi) a Duration modello per la leggibilità.

da azure-spring-boot-starter-storage a spring-cloud-azure-starter-storage-blob

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-storage-blob dalla versione 3 di azure-spring-boot-starter-storage.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Tutti i nomi delle proprietà di configurazione hanno modificato il prefisso da azure.storage a spring.cloud.azure.storage.blob.

La tabella seguente illustra i mapping delle proprietà da azure-spring-boot-starter-storage a spring-cloud-azure-starter-storage-blob:

Modifiche api

La tabella seguente illustra i mapping delle classi da azure-spring-boot-starter-storage a spring-cloud-azure-starter-storage-blob:

da azure-spring-boot-starter-storage a spring-cloud-azure-starter-storage-file-share

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-storage-file-share dalla versione 3 di azure-spring-boot-starter-storage.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Tutti i nomi delle proprietà di configurazione hanno modificato il prefisso da azure.storage a spring.cloud.azure.storage.fileshare.

La tabella seguente illustra i mapping delle proprietà da azure-spring-boot-starter-storage a spring-cloud-azure-starter-storage-file-share:

Modifiche api

La tabella seguente illustra i mapping delle classi da azure-spring-boot-starter-storage a spring-cloud-azure-starter-storage-file-share:

da azure-spring-cloud-starter-eventhubs a spring-cloud-azure-starter-integration-eventhubs

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-integration-eventhubs dalla versione 2 di azure-spring-cloud-starter-eventhubs.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Per le modifiche alle voci figlio per questo prefisso, vedere le tabelle seguenti:

Nella tabella seguente vengono illustrati i mapping delle proprietà da azure-spring-cloud-starter-eventhubs a spring-cloud-azure-starter-integration-eventhubs:

Ad esempio, cambiare da:

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}

A:

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}

Modifiche api

• Per le modifiche alle annotazioni del listener, vedere la guida alla migrazione di <<migrazione-azure-spring-cloud-messaging, azure-spring-cloud-messaging>> libreria.
• Eliminare EventHubOperation con la funzione di sottoscrizione spostata nella classe EventHubsMessageListenerContainer e la funzione di invio è stata spostata in EventHubsTemplate.
• Rinominare EventHubInboundChannelAdapter come EventHubsInboundChannelAdapter per mantenere la coerenza con il servizio di Azure Event Hubs.
• Modificare il costruttore da EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String) a EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer) e EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode).
• Modificare CheckpointConfig stile di creazione di istanze nel costruttore semplice anziché nello stile di compilazione.
• Eliminare l'API EventHubOperation#setCheckpointConfig. Per impostare la configurazione del checkpoint per l'adattatore del canale in ingresso, gli utenti possono chiamare il metodo EventHubsContainerProperties#setCheckpointConfig.
• Eliminare l'API EventHubOperation#setBatchConsumerConfig. Per impostare la configurazione che usa batch per l'adattatore del canale in ingresso, gli utenti possono chiamare i due metodi EventHubsContainerProperties#getBatch#setMaxSize e EventHubsContainerProperties#getBatch#setMaxWaitTime nel frattempo.
• Per la modalità di utilizzo batch, modificare i nomi delle intestazioni dei messaggi convertiti da messaggi in batch.
  • Modificare l'intestazione del messaggio da azure_eventhub_enqueued_time a azure_eventhubs_batch_converted_enqueued_time.
  • Modificare l'intestazione del messaggio da azure_eventhub_offset a azure_eventhubs_batch_converted_offset.
  • Modificare l'intestazione del messaggio da azure_eventhub_sequence_number a azure_eventhubs_batch_converted_sequence_number.
  • Modificare l'intestazione del messaggio da azure_partition_key a azure_batch_converted_partition_key.
• Quando si pubblicano messaggi in Hub eventi, ignorare tutte le intestazioni di messaggio convertite da messaggi in batch. Le intestazioni includono:
  • 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
• La modalità checkpoint BATCH funziona solo in modalità di utilizzo batch, che può essere abilitata passando ListenerMode.BATCH al costruttore EventHubsInboundChannelAdapter.

La tabella seguente illustra i mapping delle classi da azure-spring-cloud-starter-eventhubs a spring-cloud-azure-starter-integration-eventhubs:

Frammento di codice di esempio

• EventHubsInboundChannelAdapter codice di esempio:

  Codice legacy:

  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;
      }
  }
  

  Codice moderno:

  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 codice di esempio:

  Codice legacy:

  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;
      }
  }
  

  Codice moderno:

  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;
      }
  }
  

da azure-spring-integration-eventhubs a spring-integration-azure-eventhubs

Questa guida è progettata per facilitare la migrazione a spring-integration-azure-eventhubs dalla versione 2 di azure-spring-integration-eventhubs.

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.

Modifiche api

• Eliminare EventHubOperation con la funzione di sottoscrizione spostata nella classe EventHubsMessageListenerContainer e la funzione di invio è stata spostata in EventHubsTemplate.
• Rinominare EventHubInboundChannelAdapter come EventHubsInboundChannelAdapter per mantenere la coerenza con il servizio di Azure Event Hubs.
• Modificare il costruttore da EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String) a EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer) e EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode).
• Modificare CheckpointConfig stile di creazione di istanze nel costruttore semplice anziché nello stile di compilazione.
• Eliminare l'API EventHubOperation#setCheckpointConfig. Per impostare la configurazione del checkpoint per l'adattatore del canale in ingresso, gli utenti possono chiamare il metodo EventHubsContainerProperties#setCheckpointConfig.
• Eliminare l'API EventHubOperation#setBatchConsumerConfig. Per impostare la configurazione che usa batch per l'adattatore del canale in ingresso, gli utenti possono chiamare i due metodi EventHubsContainerProperties#getBatch#setMaxSize e EventHubsContainerProperties#getBatch#setMaxWaitTime nel frattempo.
• Per la modalità di utilizzo batch, modificare i nomi delle intestazioni dei messaggi convertiti da messaggi in batch.
  • Modificare l'intestazione del messaggio da azure_eventhub_enqueued_time a azure_eventhubs_batch_converted_enqueued_time.
  • Modificare l'intestazione del messaggio da azure_eventhub_offset a azure_eventhubs_batch_converted_offset.
  • Modificare l'intestazione del messaggio da azure_eventhub_sequence_number a azure_eventhubs_batch_converted_sequence_number.
  • Modificare l'intestazione del messaggio da azure_partition_key a azure_batch_converted_partition_key.
• Quando si pubblicano messaggi in Hub eventi, ignorare tutte le intestazioni di messaggio convertite da messaggi in batch. Le intestazioni includono:
  • 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
• La modalità checkpoint BATCH funziona solo in modalità di utilizzo batch, che può essere abilitata passando ListenerMode.BATCH al costruttore EventHubsInboundChannelAdapter.

La tabella seguente illustra i mapping delle classi da azure-spring-integration-eventhubs a spring-integration-azure-eventhubs:

da azure-spring-cloud-starter-servicebus a spring-cloud-azure-starter-integration-servicebus

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-integration-servicebus dalla versione 2 di azure-spring-cloud-starter-servicebus.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Per tutte le opzioni di configurazione supportate in spring-cloud-azure-starter-integration-servicebus, il prefisso rimane come spring.cloud.azure.servicebus.

La tabella seguente illustra i mapping delle proprietà da azure-spring-cloud-starter-servicebus a spring-cloud-azure-starter-integration-servicebus:

Modifiche api

• Eliminare ServiceBusQueueOperation e ServiceBusTopicOperation con la funzione di sottoscrizione spostata nella classe ServiceBusMessageListenerContainer e la funzione di invio spostata in ServiceBusTemplate.
• Eliminare ServiceBusQueueInboundChannelAdapter e ServiceBusTopicInboundChannelAdapter e spostare la funzionalità per ascoltare un'entità coda/argomento Service Bus in ServiceBusInboundChannelAdapter.
• Modificare il costruttore da ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) e ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Modificare il costruttore da ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) e ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Eliminare le API ServiceBusQueueOperation#setCheckpointConfig e ServiceBusTopicOperation#setCheckpointConfig. Per impostare la configurazione del checkpoint per l'adattatore del canale in ingresso, gli utenti possono invece chiamare il metodo ServiceBusContainerProperties#setAutoComplete. Per disabilitare la modalità di completamento automatico equivale a MANUAL modalità di checkpoint e per abilitarla attiverà la modalità di RECORD.
• Eliminare le API ServiceBusQueueOperatio#setClientConfig e ServiceBusTopicOperation#setClientConfig. Per configurare la ServiceBusProcessorClient sottostante usata dall'adattatore del canale in ingresso, gli utenti possono invece usare ServiceBusContainerProperties.
• Eliminare CompletableFuture supporto in ServiceBusTemplate e DefaultMessageHandler, supportare Reactor.
• Aggiungere una nuova API di ServiceBusTemplate#setDefaultEntityType per specificare il tipo di entità, necessario quando non viene fornito alcun bean di PropertiesSupplier<String, ProducerProperties> per il ProducerProperties#entityType.
• Eliminare l'intestazione del messaggio AzureHeaders.RAW_ID. Utilizzare invece ServiceBusMessageHeaders.MESSAGE_ID.

La tabella seguente illustra i mapping delle classi da azure-spring-cloud-starter-servicebus a spring-cloud-azure-starter-integration-servicebus:

Frammento di codice di esempio

• ServiceBusInboundChannelAdapter codice di esempio:

  Codice legacy dell'uso di ServiceBusQueueInboundChannelAdapter o 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;
      }
  
  }
  

  Codice moderno:

  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 codice di esempio:

  Codice legacy, prendendo la coda come esempio:

  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;
      }
  }
  

  Codice moderno:

  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;
      }
  }
  

da azure-spring-integration-servicebus a spring-integration-azure-servicebus

Questa guida è progettata per facilitare la migrazione a spring-integration-azure-servicebus dalla versione 2 di azure-spring-integration-servicebus.

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.

Modifiche api

• Eliminare ServiceBusQueueOperation e ServiceBusTopicOperation con la funzione di sottoscrizione spostata nella classe ServiceBusMessageListenerContainer e la funzione di invio spostata in ServiceBusTemplate.
• Eliminare ServiceBusQueueInboundChannelAdapter e ServiceBusTopicInboundChannelAdapter e spostare la funzionalità per ascoltare un'entità coda/argomento Service Bus in ServiceBusInboundChannelAdapter.
• Modificare il costruttore da ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) e ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Modificare il costruttore da ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) e ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Eliminare le API ServiceBusQueueOperation#setCheckpointConfig e ServiceBusTopicOperation#setCheckpointConfig. Per impostare la configurazione del checkpoint per l'adattatore del canale in ingresso, gli utenti possono invece chiamare il metodo ServiceBusContainerProperties#setAutoComplete. Per disabilitare la modalità di completamento automatico equivale a MANUAL modalità di checkpoint e per abilitarla attiverà la modalità di RECORD.
• Eliminare le API ServiceBusQueueOperation#setClientConfig e ServiceBusTopicOperation#setClientConfig. Per configurare la ServiceBusProcessorClient sottostante usata dall'adattatore del canale in ingresso, gli utenti possono invece usare ServiceBusContainerProperties.
• Eliminare CompletableFuture supporto in ServiceBusTemplate e DefaultMessageHandler, supportare Reactor.
• Aggiungere una nuova API di ServiceBusTemplate#setDefaultEntityType per specificare il tipo di entità, necessario quando non viene fornito alcun bean di PropertiesSupplier<String, ProducerProperties> per il ProducerProperties#entityType.
• Eliminare l'intestazione del messaggio AzureHeaders.RAW_ID. Utilizzare invece ServiceBusMessageHeaders.MESSAGE_ID.

La tabella seguente illustra i mapping delle classi da azure-spring-integration-servicebus a spring-integration-azure-servicebus:

da azure-spring-cloud-starter-storage-queue a spring-cloud-azure-starter-integration-storage-queue

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-starter-integration-storage-queue dalla versione 2 di azure-spring-cloud-starter-storage-queue.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Tutti i nomi delle proprietà di configurazione hanno modificato il prefisso da spring.cloud.azure.storage a spring.cloud.azure.storage.queue.

La tabella seguente illustra i mapping delle proprietà da azure-spring-cloud-starter-storage-queue a spring-cloud-azure-starter-integration-storage-queue:

Modifiche api

• Eliminare StorageQueueOperation e fornire StorageQueueTemplate.
• Eliminare checkpoint-mode configurazione in StorageQueueTemplate, supporta solo la modalità di MANUAL.

Nella tabella seguente vengono illustrati i mapping delle classi da azure-spring-cloud-starter-storage-queue a spring-cloud-azure-starter-integration-storage-queue.

da azure-spring-integration-storage-queue a spring-integration-azure-storage-queue

Questa guida è progettata per facilitare la migrazione a spring-integration-azure-storage-queue dalla versione 2 di azure-spring-integration-storage-queue.

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.

Modifiche api

• Eliminare StorageQueueOperation e fornire StorageQueueTemplate.
• Eliminare checkpoint-mode configurazione in StorageQueueTemplate, supporta solo la modalità di MANUAL.

Nella tabella seguente vengono illustrati i mapping delle classi da azure-spring-integration-storage-queue a spring-integration-azure-storage-queue.

da azure-spring-cloud-stream-binder-eventhubs a spring-cloud-azure-stream-binder-eventhubs

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-stream-binder-eventhubs dalla versione 2 di azure-spring-cloud-stream-binder-eventhubs.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Per le modifiche apportate alle voci figlio per il prefisso seguente, vedere la tabella seguente.

Nella tabella seguente vengono illustrati i mapping delle proprietà da azure-spring-cloud-stream-binder-eventhubs a spring-cloud-azure-stream-binder-eventhubs:

Esempi di migrazione della configurazione

Per usare il connection string per l'autenticazione ed eseguire la migrazione delle proprietà indicate in precedenza, le modifiche di configurazione sono elencate di seguito:

Configurazione legacy:

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

Configurazione moderna:

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

Se si usano entità di sicurezza anziché stringhe di connessione, nelle versioni precedenti alla 4.0 l'applicazione si connetterà prima a Azure Resource Manager (ARM) con l'entità di sicurezza fornita e quindi recupererà il connection string dello spazio dei nomi specificato con ARM. Alla fine l'applicazione usa il connection string recuperato per connettersi a Azure Event Hubs. In questo modo, l'entità di sicurezza fornita deve essere concessa con il ruolo Contributor per recuperare lo spazio dei nomi Azure Event Hubs associato.

Per Azure Spring Apps 4.0, sono disponibili due modi per sfruttare le entità di sicurezza per l'autenticazione. Uno usa ancora le entità per connettersi ad ARM e recuperare le stringhe di connessione in cui è necessario il ruolo Contributor per le entità. L'altro usa le entità di sicurezza per eseguire l'autenticazione a Microsoft Entra ID e quindi connettersi direttamente a Azure Event Hubs. In questo caso, il ruolo Contributor non è più necessario, mentre altri ruoli correlati Data sono necessari per le operazioni di messaggistica. Per assicurarsi che all'entità di sicurezza sia stata concessa l'autorizzazione sufficiente per accedere alla risorsa Azure, vedere Autorizzare l'accesso con Microsoft Entra ID.

Per l'autenticazione basata su ARM, prendendo l'entità servizio, ad esempio, la migrazione della configurazione è elencata di seguito, in cui il ruolo assegnato non deve cambiare:

Configurazione legacy:

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}

Sono necessarie la configurazione moderna, le proprietà per Azure ID sottoscrizione e gruppo di risorse:

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}

È anche possibile eseguire la migrazione per eseguire l'autenticazione e l'autorizzazione con Microsoft Entra ID direttamente senza effettuare una deviazione verso ARM. Assicurarsi di concedere all'entità di sicurezza necessaria Data ruoli per le operazioni di messaggistica. Di seguito sono elencati gli esempi di configurazione dell'entità servizio e dell'identità gestita:

• Con un'entità servizio

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

• Con un'identità gestita

  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}
  

Modifiche api

Nella tabella seguente vengono illustrati i mapping delle classi da azure-spring-cloud-stream-binder-eventhubs a spring-cloud-azure-stream-binder-eventhubs.

da azure-spring-cloud-stream-binder-servicebus-* a spring-cloud-azure-stream-binder-servicebus

Questa guida è progettata per facilitare la migrazione a spring-cloud-azure-stream-binder-servicebus dalla versione 2 di azure-spring-cloud-stream-binder-servicebus-queue o azure-spring-cloud-binder-servicebus-topic.

Per informazioni generali, usare i collegamenti seguenti:

• Per una panoramica delle modifiche nella versione 4.0, vedere le sezioni introduzione e vantaggi della migrazione.
• Per altre informazioni sulle modifiche alla strategia nella denominazione del progetto, vedere la sezione Modifiche alla denominazione.
• Per informazioni su come usare un bom per tutte le librerie spring cloud Azure, vedere la sezione BOM.
• Per informazioni su come gestire l'autenticazione in Spring Cloud Azure 4.0, vedere la sezione Modificare l'autenticazione.
• Per informazioni su come sfruttare spring-boot-properties-migrator durante la migrazione, vedere la sezione Configurare ogni sdk.
• Per altre informazioni sulle modifiche di configurazione globali e comuni, vedere la sezione configurazioni globali.

Modifiche alla configurazione dell'SDK

Nella tabella seguente sono elencate le nuove proprietà di configurazione di spring-cloud-azure-stream-binder-servicebus:

La tabella seguente illustra i mapping delle proprietà da azure-spring-cloud-stream-binder-servicebus-* a spring-cloud-azure-stream-binder-servicebus:

Esempi di migrazione della configurazione

Configurazione legacy, esecuzione della coda come esempio:

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

Configurazione moderna:

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

Se si usano entità di sicurezza anziché stringhe di connessione, nelle versioni precedenti alla 4.0 l'applicazione si connetterà prima a Azure Resource Manager (ARM) con l'entità di sicurezza fornita e quindi recupererà il connection string dello spazio dei nomi specificato con ARM. Alla fine l'applicazione usa il connection string recuperato per connettersi a Azure Service Bus. In questo modo l'entità di sicurezza fornita deve essere concessa con il ruolo Contributor per recuperare lo spazio dei nomi Azure Service Bus associato.

Per Azure Spring Apps 4.0, sono disponibili due modi per sfruttare le entità di sicurezza per l'autenticazione. Uno usa ancora le entità per connettersi ad ARM e recuperare le stringhe di connessione in cui è necessario il ruolo Contributor per le entità. L'altro usa le entità di sicurezza per eseguire l'autenticazione a Microsoft Entra ID e quindi connettersi direttamente al Azure Service Bus. In questo caso, il ruolo Contributor non è più necessario, mentre altri ruoli correlati Data sono necessari per le operazioni di messaggistica. Per assicurarsi che all'entità di sicurezza sia stata concessa l'autorizzazione sufficiente per accedere alla risorsa Azure, vedere Autorizzare l'accesso con Microsoft Entra ID.

Per l'autenticazione basata su ARM, prendendo l'entità servizio, ad esempio, la migrazione della configurazione è elencata di seguito, in cui il ruolo assegnato non deve cambiare:

Configurazione legacy:

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}

Sono necessarie la configurazione moderna, le proprietà per Azure ID sottoscrizione e gruppo di risorse:

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}

È anche possibile eseguire la migrazione per eseguire l'autenticazione e l'autorizzazione con Microsoft Entra ID direttamente senza effettuare una deviazione verso ARM. Assicurarsi di concedere all'entità di sicurezza necessaria Data ruoli per le operazioni di messaggistica. Di seguito sono elencati gli esempi di configurazione dell'entità servizio e dell'identità gestita:

• Con un'entità servizio

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

• Con un'identità gestita

  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}
  

Modifiche api

• Eliminare l'intestazione del messaggio AzureHeaders.RAW_ID. Utilizzare invece ServiceBusMessageHeaders.MESSAGE_ID.

Nella tabella seguente vengono illustrati i mapping delle classi da azure-spring-cloud-stream-binder-eventhubs a spring-cloud-azure-stream-binder-eventhubs.

azure-spring-cloud-messaging

La libreria com.azure.spring:azure-spring-cloud-messaging non è pronta per la versione 4.0. La funzione delle annotazioni del listener è in fase di riprogettazione, pertanto le annotazioni @AzureMessageListener, @AzureMessageListenerse @EnableAzureMessaging non sono attualmente supportate.