Delen via


Ontwikkelaarshandleiding voor Spring Cloud Azure

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.

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.