Ontwikkelaarshandleiding voor Spring Cloud Azure

Artikel
10/23/2023

Dit artikel is van toepassing op: ✔️ versie 4.14.0 ✔️ versie 5.8.0

Spring is een opensource-toepassingsframework dat is ontwikkeld door VMware en biedt een vereenvoudigde, modulaire benadering voor het maken van Java-toepassingen. Spring Cloud Azure is een opensource-project dat naadloze Spring-integratie met Azure biedt.

Zie Spring Versions Mapping voor meer informatie over ondersteunde versies.

Ondersteuning

Als u vragen hebt over deze documentatie, maakt u een GitHub-probleem in een van de volgende GitHub-opslagplaatsen. Pull-aanvragen zijn ook welkom.

GitHub-opslagplaatsen	Beschrijving
Azure/azure-sdk-for-java	Deze opslagplaats bevat de broncode.
MicrosoftDocs/azure-dev-docs	Deze opslagplaats bevat de documentatie.

Wat is er nieuw in 4.0 sinds 3.10.x

Deze documentatie bevat informatie over wijzigingen die zijn aangebracht in 4.0 sinds 3.10. Deze grote release biedt betere beveiliging, leaner afhankelijkheden, ondersteuning voor productiegereedheid en meer.

Tip

Zie de migratiehandleiding voor 4.0 voor meer informatie over migreren naar 4.0.

De volgende lijst bevat een overzicht van enkele van de wijzigingen die Spring Cloud Azure 4.0 biedt:

Een uniforme ontwikkelervaring, met uniforme projectnaam, artefact-id en eigenschappen.
Vereenvoudigd afhankelijkheidsbeheer met één spring-cloud-azure-dependencies bom.
Uitgebreide ondersteuning voor Azure op Spring Initializr voor Kafka, Event Hubs, Azure Cache voor Redis en Azure-app Configuration.
Opnieuw gearchitecteerde Spring-moduleafhankelijkheden om overtollige lagen en verstrengeling te verwijderen.
Ondersteuning voor beheerde identiteiten voor Azure-app Configuratie, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob en Storage Queue.
Ondersteuning voor verificatiemethoden in de onderliggende Azure SDK van onze Spring-bibliotheken, zoals SAS-token- en tokenreferentieverificatie met Service Bus en Event Hubs.
Referentieketen is nu standaard ingeschakeld, zodat toepassingen referenties kunnen ophalen uit toepassingseigenschappen, omgevingsvariabelen, beheerde identiteit, IDE's enzovoort. Zie de sectie DefaultAzureCredential van de Azure Identity-clientbibliotheek voor Java voor meer informatie.
Gedetailleerd toegangsbeheer op resourceniveau (zoals Service Bus-wachtrij) om beter beveiligingsbeheer en naleving van IT-beleid mogelijk te maken.
Meer opties die op een spring-idiomatische manier worden weergegeven door een aanzienlijk verbeterde automatische configuratiedekking van Azure SDK-clients voor zowel synchrone als asynchrone scenario's.
Statusindicatoren toegevoegd voor Azure-app Configuratie, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue en Storage File.
Spring Cloud Sleuth-ondersteuning voor alle OP HTTP gebaseerde Azure SDK's.

Migratiehandleiding voor 4.0

Zie de migratiehandleiding voor 4.0 voor meer informatie over migreren naar 4.0.

Aan de slag

Afhankelijkheden instellen

Stuklijst

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

Notitie

Als u Spring Boot 3.x gebruikt, moet u de spring-cloud-azure-dependencies versie instellen op 5.8.0. Zie welke versie van Spring Cloud Azure moet ik gebruiken voor meer informatie over de spring-cloud-azure-dependencies versie.

Starter-afhankelijkheden

Spring Cloud Azure Starters zijn een set handige afhankelijkheidsdescriptors die u in uw toepassing kunt opnemen. Elke starter bevat alle afhankelijkheden en transitieve afhankelijkheden die nodig zijn om de bijbehorende Spring Cloud Azure-module te gaan gebruiken. Deze starters stimuleren de ontwikkeling van uw Spring Boot-toepassing met Azure-services.

Als u bijvoorbeeld aan de slag wilt met Spring en Azure Cosmos DB voor gegevenspersistentie, neemt u de spring-cloud-azure-starter-cosmos afhankelijkheid in uw project op.

De volgende tabel bevat toepassingsstarters van Spring Cloud Azure onder de com.azure.spring groep:

Name	Beschrijving
spring-cloud-azure-starter	De kernstarter, inclusief ondersteuning voor automatische configuratie.
spring-cloud-azure-starter-active-directory	De starter voor het gebruik van Microsoft Entra ID met Spring Security.
spring-cloud-azure-starter-active-directory-b2c	De starter voor het gebruik van Azure Active Directory B2C met Spring Security.
spring-cloud-azure-starter-appconfiguration	De starter voor het gebruik van Azure-app Configuration.
spring-cloud-azure-starter-cosmos	De starter voor het gebruik van Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs	De starter voor het gebruik van Azure Event Hubs.
spring-cloud-azure-starter-keyvault	De starter voor het gebruik van Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets	De starter voor het gebruik van Azure Key Vault-geheimen.
spring-cloud-azure-starter-keyvault-certificates	De starter voor het gebruik van Azure Key Vault-certificaten.
spring-cloud-azure-starter-servicebus	De starter voor het gebruik van Azure Service Bus.
spring-cloud-azure-starter-servicebus-jms	De starter voor het gebruik van Azure Service Bus en JMS.
spring-cloud-azure-starter-storage	De starter voor het gebruik van Azure Storage.
spring-cloud-azure-starter-storage-blob	De starter voor het gebruik van Azure Storage Blob.
spring-cloud-azure-starter-storage-file-share	De starter voor het gebruik van Azure Storage-bestandsshare.
spring-cloud-azure-starter-storage-queue	De starter voor het gebruik van Azure Storage Queue.
spring-cloud-azure-starter-actuator	De starter voor het gebruik van Spring Boot's Actuator, die productieklare functies biedt.

De volgende tabel bevat starters voor Spring Data-ondersteuning:

Name	Beschrijving
spring-cloud-azure-starter-data-cosmos	De starter voor het gebruik van Spring Data voor Azure Cosmos DB.

De volgende tabel bevat starters voor Spring Integration-ondersteuning:

Name	Beschrijving
spring-cloud-azure-starter-integration-eventhubs	De starter voor het gebruik van Azure Event Hubs en Spring Integration.
spring-cloud-azure-starter-integration-servicebus	De starter voor het gebruik van Azure Service Bus en Spring Integration.
spring-cloud-azure-starter-integration-storage-queue	De starter voor het gebruik van Azure Storage Queue en Spring Integration.

De volgende tabel bevat starters voor Spring Cloud Stream-ondersteuning:

Name	Beschrijving
spring-cloud-azure-starter-stream-eventhubs	De starters voor het gebruik van Azure Event Hubs en Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus	De starter voor het gebruik van Azure Service Bus en Spring Cloud Stream Binder.

De volgende tabel bevat starters voor MySQL-ondersteuning:

Name	Beschrijving
spring-cloud-azure-starter-jdbc-mysql	De starters voor het gebruik van Azure MySQLs en JDBC via Microsoft Entra-verificatie.

De volgende tabel bevat starters voor PostgreSQL-ondersteuning:

Name	Beschrijving
spring-cloud-azure-starter-jdbc-postgresql	De starters voor het gebruik van Azure PostgreSQL en JDBC via Microsoft Entra-verificatie.

Spring Cloud Azure leren

We hebben een volledige lijst met voorbeelden voorbereid om gebruik weer te geven. U vindt deze voorbeelden op Spring Cloud Azure Samples.