Spring Cloud Azure fejlesztői útmutató

Cikk
10/23/2023

Ez a cikk a következőre vonatkozik: ✔️ 4.14.0 ✔️ 5.8.0-s verzió

A Spring a VMware által kifejlesztett nyílt forráskódú alkalmazás-keretrendszer, amely egyszerűsített, moduláris megközelítést biztosít a Java-alkalmazások létrehozásához. A Spring Cloud Azure egy nyílt forráskódú projekt, amely zökkenőmentes Spring-integrációt biztosít az Azure-ral.

A támogatott verziókról további információt a Spring Versions Mapping című témakörben talál.

Támogatás kérése

Ha kérdése van a dokumentációval kapcsolatban, hozzon létre egy GitHub-problémát az alábbi GitHub-adattárak egyikében. A lekéréses kérelmeket is szívesen látjuk.

GitHub-adattárak	Leírás
Azure/azure-sdk-for-java	Ez az adattár tartalmazza a forráskódot.
MicrosoftDocs/azure-dev-docs	Ez az adattár tartalmazza a dokumentációt.

A 4.0 újdonságai a 3.10.x óta

Ez a dokumentáció a 4.0 3.10 óta végrehajtott módosításokat ismerteti. Ez a fő kiadás nagyobb biztonságot, soványabb függőségeket, az éles üzemkészség támogatását és egyebeket biztosít.

Tipp.

A 4.0-ra való migrálásról további információt a 4.0-s migrálási útmutatóban talál.

Az alábbi lista összefoglalja a Spring Cloud Azure 4.0 által biztosított néhány módosítást:

Egységes fejlesztési felület egységes projektnévvel, összetevő-azonosítóval és tulajdonságokkal.
Egyszerűsített függőségkezelés egyetlen spring-cloud-azure-dependencies anyagjegyzék használatával.
Bővített Azure-támogatás a Spring Initializrben a Kafka, az Event Hubs, az Azure Cache for Redis és a Azure-alkalmazás Configuration lefedéséhez.
A Spring-modul függőségeinek újratervezése a felesleges rétegek és összefonódások eltávolításához.
Felügyelt identitás támogatása Azure-alkalmazás konfigurációhoz, Event Hubshoz, Service Bushoz, Azure Cosmos DB-hez, Key Vaulthoz, Storage Blobhoz és Tárolási üzenetsorhoz.
A Spring-kódtárakból származó, az alapul szolgáló Azure SDK hitelesítési módszereinek folyamatos támogatása, például SAS-jogkivonat és token hitelesítő adatok hitelesítése a Service Bus és az Event Hubs használatával.
A hitelesítőadat-lánc alapértelmezés szerint engedélyezve van, így az alkalmazások hitelesítő adatokat szerezhetnek be az alkalmazás tulajdonságaiból, környezeti változóiból, felügyelt identitásából, azonosítóiból stb. További információ: A Java-hoz készült Azure Identity ügyfélkódtár DefaultAzureCredential szakasza.
Részletes hozzáférés-vezérlés erőforrásszinten (például Service Bus-üzenetsor) a jobb biztonság szabályozása és az informatikai szabályzatok betartása érdekében.
A Spring-idiomatic módon elérhető további lehetőségek az Azure SDK-ügyfelek jelentősen továbbfejlesztett automatikus konfigurációs lefedettségén keresztül szinkron és aszinkron forgatókönyvek esetén is.
A Azure-alkalmazás Konfiguráció, Az Event Hubs, az Azure Cosmos DB, a Key Vault, a Storage Blob, a Storage Queue és a Storage File állapotjelzői hozzáadva.
Spring Cloud Sleuth-támogatás minden HTTP-alapú Azure SDK-hoz.

Migrálási útmutató a 4.0-hoz

A 4.0-ra való migrálásról további információt a 4.0-s migrálási útmutatóban talál.

Első lépések

Függőségek beállítása

Anyagjegyzék (BOM)

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

Megjegyzés:

Ha Spring Boot 3.x-et használ, mindenképpen állítsa be a verziót5.8.0.spring-cloud-azure-dependencies A verzióról további információt a spring-cloud-azure-dependencies Spring Cloud Azure melyik verzióját érdemes használni.

Kezdő függőségek

A Spring Cloud Azure Starters kényelmes függőségi leírók készlete, amelyeket belefoglalhat az alkalmazásba. Minden kezdő tartalmazza az összes függőséget és tranzitív függőséget, amely a megfelelő Spring Cloud Azure-modul használatának megkezdéséhez szükséges. Ezek a kezdők növelik a Spring Boot-alkalmazások fejlesztését az Azure-szolgáltatásokkal.

Ha például el szeretné kezdeni a Spring és az Azure Cosmos DB használatát az adatmegőrzéshez, vegye fel a függőséget a spring-cloud-azure-starter-cosmos projektbe.

Az alábbi táblázat a Spring Cloud Azure által a csoport alatt biztosított alkalmazásindítókat sorolja fel com.azure.spring :

Name	Leírás
spring-cloud-azure-starter	Az alapindító, beleértve az automatikus konfigurációs támogatást is.
spring-cloud-azure-starter-active-directory	A Microsoft Entra ID és a Spring Security használatának kezdője.
spring-cloud-azure-starter-active-directory-b2c	Az Azure Active Directory B2C és a Spring Security használatának kezdője.
spring-cloud-azure-starter-appconfiguration	A Azure-alkalmazás Configuration használatának kezdője.
spring-cloud-azure-starter-cosmos	Az Azure Cosmos DB használatának kezdője.
spring-cloud-azure-starter-eventhubs	Az Azure Event Hubs használatának kezdője.
spring-cloud-azure-starter-keyvault	A Starter az Azure Key Vault használatához.
spring-cloud-azure-starter-keyvault-secrets	Az Azure Key Vault titkos kulcsainak használatának kezdő eleme.
spring-cloud-azure-starter-keyvault-certificates	Az Azure Key Vault-tanúsítványok használatának kezdő eleme.
spring-cloud-azure-starter-servicebus	Az Azure Service Bus használatának kezdője.
spring-cloud-azure-starter-servicebus-jms	Az Azure Service Bus és a JMS használatának kezdője.
spring-cloud-azure-starter-storage	Az Azure Storage használatának kezdője.
spring-cloud-azure-starter-storage-blob	Az Azure Storage Blob használatának kezdője.
spring-cloud-azure-starter-storage-file-share	Az Azure Storage-fájlmegosztás használatának kezdője.
spring-cloud-azure-starter-storage-queue	Az Azure Storage Queue használatának kezdője.
spring-cloud-azure-starter-actuator	A Spring Boot Actuator használatának kezdője, amely éles használatra kész funkciókat biztosít.

Az alábbi táblázat a Spring Data-támogatás kezdőit sorolja fel:

Name	Leírás
spring-cloud-azure-starter-data-cosmos	Az Azure Cosmos DB-hez készült Spring Data használatának kezdője.

Az alábbi táblázat a Spring Integration támogatás kezdőit sorolja fel:

Name	Leírás
spring-cloud-azure-starter-integration-eventhubs	Az Azure Event Hubs és a Spring Integration használatának kezdője.
spring-cloud-azure-starter-integration-servicebus	Az Azure Service Bus és a Spring Integration használatának kezdője.
spring-cloud-azure-starter-integration-storage-queue	Az Azure Storage Queue és a Spring Integration használatának kezdője.

Az alábbi táblázat a Spring Cloud Stream támogatásának kezdőit sorolja fel:

Name	Leírás
spring-cloud-azure-starter-stream-eventhubs	Az Azure Event Hubs és a Spring Cloud Stream Binder használatának kezdői.
spring-cloud-azure-starter-stream-servicebus	Az Azure Service Bus és a Spring Cloud Stream Binder használatának kezdője.

Az alábbi táblázat a MySQL-támogatás kezdőit sorolja fel:

Name	Leírás
spring-cloud-azure-starter-jdbc-mysql	Az Azure MySQLs és a JDBC Microsoft Entra-hitelesítésen keresztüli használatának kezdő állomásai.

Az alábbi táblázat a PostgreSQL-támogatás kezdőit sorolja fel:

Name	Leírás
spring-cloud-azure-starter-jdbc-postgresql	Az Azure PostgreSQL és a JDBC Microsoft Entra-hitelesítésen keresztüli használatának kezdői.

Tanulás Spring Cloud Azure

Elkészítettük a minták teljes listáját a használat megjelenítéséhez. Ezeket a mintákat a Spring Cloud Azure-mintákban találja.