Guida per sviluppatori di Spring Cloud Azure

Spring è un framework applicativo open source sviluppato da VMware che offre un approccio modulare semplificato per la creazione di applicazioni Java. Spring Cloud Azure è un progetto open source che offre un'integrazione spring senza problemi con Azure.

Per altre informazioni sulle versioni supportate, vedere Spring Versions Mapping.

Ottenere assistenza

In caso di domande su questa documentazione, creare un problema di GitHub in uno dei repository di GitHub seguenti. Anche le richieste pull sono benvenute.

Introduttiva

Configurazione delle dipendenze

Distinta base (BOM)

Se si usa Maven, aggiungere la distinta base al file pom.xml nella sezione dependencyManagement, come illustrato nell'esempio seguente. Quando si usa la distinta base, non è necessario specificare le versioni per una delle dipendenze Maven perché il controllo delle versioni viene delegato alla distinta base.

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

Con Gradle, è possibile importare la distinta base spring-cloud-azure-dependencies nei modi seguenti:

• Usare il supporto bom nativo di Gradle aggiungendo dipendenze, come illustrato nell'esempio seguente:

  import org.springframework.boot.gradle.plugin.SpringBootPlugin
  
  plugins {
    id("java")
    id("org.springframework.boot") version "4.0.1"
  }
  
  dependencies {
      implementation(platform(SpringBootPlugin.BOM_COORDINATES))
      implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}"))
  }
  

• Usare il plug-in io.spring.dependency-management e importare la distinta base in dependencyManagement, come illustrato nell'esempio seguente:

  plugins {
      id("io.spring.dependency-management") version "1.1.7"
  }
  
  dependencyManagement {
      imports {
          mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}")
      }
  }
  

Per altre informazioni, vedere Spring Boot Gradle Plugin Reference Guide.

Dipendenze di avvio

Spring Cloud Azure Starters è un set di utili descrittori di dipendenza da includere nell'applicazione. Ogni avvio contiene tutte le dipendenze e le dipendenze transitive necessarie per iniziare a usare il modulo spring cloud Azure corrispondente. Questi strumenti di avvio migliorano lo sviluppo di applicazioni Spring Boot con servizi di Azure.

Ad esempio, se si vuole iniziare a usare Spring e Azure Cosmos DB per la persistenza dei dati, includere la dipendenza spring-cloud-azure-starter-cosmos nel progetto.

La tabella seguente elenca gli starter dell'applicazione forniti da Spring Cloud Azure nel gruppo com.azure.spring:

La tabella seguente elenca gli starter per il supporto di Spring Data:

La tabella seguente elenca gli starter per il supporto di Spring Data Redis:

La tabella seguente elenca gli starter per il supporto di Spring Integration:

La tabella seguente elenca gli starter per il supporto di Spring Cloud Stream:

La tabella seguente elenca gli starter per il supporto di MySQL:

La tabella seguente elenca gli starter per il supporto di PostgreSQL:

Learning Spring Cloud Azure

Per un elenco completo degli esempi che mostrano l'utilizzo, vedere Spring Cloud Azure Samples.

Novità della versione 4.0 dalla versione 3.10.x

Questa documentazione illustra le modifiche apportate nella versione 4.0 dalla versione 3.10. Questa versione principale offre maggiore sicurezza, dipendenze più snella, supporto per l'idoneità alla produzione e altro ancora.

L'elenco seguente riepiloga alcune delle modifiche fornite da Spring Cloud Azure 4.0:

• Esperienza di sviluppo unificata, con nome di progetto unificato, ID artefatto e proprietà.
• Gestione semplificata delle dipendenze tramite una singola distinta base spring-cloud-azure-dependencies.
• Azure support espanso in Spring Initializr per coprire Kafka, Hub eventi, Azure Cache for Redis e Azure App Configuration.
• Dipendenze del modulo Spring riprogettate per rimuovere i livelli in eccesso e l'entanglement.
• Supporto delle identità gestite per Azure App Configuration, Hub eventi, Service Bus, Azure Cosmos DB, Key Vault, BLOB di archiviazione e coda di archiviazione.
• Supporto continuo per i metodi di autenticazione nei Azure SDK sottostanti delle librerie Spring, ad esempio token di firma di accesso condiviso e autenticazione delle credenziali dei token con Service Bus e Hub eventi.
• La catena di credenziali è ora abilitata per impostazione predefinita, consentendo alle applicazioni di ottenere le credenziali dalle proprietà dell'applicazione, dalle variabili di ambiente, dall'identità gestita, dagli IDE e così via. Per altre informazioni, vedere la sezione DefaultAzureCredential della libreria client Azure Identity per Java.
• Controllo di accesso granulare a livello di risorsa ,ad esempio Service Bus coda, per consentire una migliore governance della sicurezza e conformità ai criteri IT.
• Altre opzioni esposte in modo idiotico Spring tramite una migliore copertura della configurazione automatica dei client Azure SDK per scenari sincroni e asincroni.
• Sono stati aggiunti indicatori di integrità per Azure App Configuration, Hub eventi, Azure Cosmos DB, Key Vault, BLOB di archiviazione, coda di archiviazione e file di archiviazione.
• Supporto di Spring Cloud Sleuth per tutti i Azure SDKs basati su HTTP.