Spring Cloud Azure fejlesztői útmutató

A Spring Cloud Azure integrálja a Spring Boot-alkalmazásokat Azure szolgáltatásokkal. Ez a fejlesztői útmutató bemutatja, hogyan kezelheti a függőségeket, választhat kezdőket, és hogyan használhat mintákat Java alkalmazásfejlesztés felgyorsításához.

A támogatott verziókkal kapcsolatos további információkért lásd a Spring-verziók leképezése című témakört.

Segítség 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 pull requesteket is szívesen fogadjuk.

GitHub adattárak	Leírás
Azure/azure-sdk-for-java	Ez az adattár tartalmazza a forráskódot.
Azure-Samples/azure-spring-boot-samples	Ez az adattár tartalmazza a kapcsolódó mintákat.
MicrosoftDocs/azure-dev-docs	Ez az adattár tartalmazza a dokumentációt.

Első lépések

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

Anyagjegyzék (BOM)

Ha Mavent használ, adja hozzá a BOM-t a pom.xml fájlhoz a dependencyManagement szakaszban, ahogy az alábbi példában is látható. A BOM használatakor nem kell a Maven-függőségek verzióit megadnia, mert a BOM kezeli a verziószámozást.

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

A Gradle-lel a következő módokon importálhatja a spring-cloud-azure-dependencies BOM-ot:

• A Gradle natív BOM-támogatásának használata függőségek hozzáadásával az alábbi példában látható módon.

  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}"))
  }
  

• Használja a(z) io.spring.dependency-management beépülő modult, és importálja a BOM-ot a(z) dependencyManagement használatával, az alábbi példában látható módon.

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

További információkért lásd a Spring Boot Gradle bővítmény referencia-útmutatót.

Jegyzet

Ha a Spring Boot 4.0.x verziót használja, állítsa a spring-cloud-azure-dependencies verziót 7.4.0-re.

Ha a Spring Boot 3.5.x-et használja, állítsa a spring-cloud-azure-dependencies verziót 6.5.0-re.

Ha a Spring Boot 3.1.x–3.5.x verzióját használja, mindenképpen állítsa a spring-cloud-azure-dependencies verzióját 5.25.0 értékre.

Ha a Spring Boot 2.x-et használja, mindenképpen állítsa be a spring-cloud-azure-dependencies verziót 4.20.0-re.

Ezt az anyagjegyzéket (BOM) a <dependencyManagement> fájl szakaszában kell konfigurálni. Ez biztosítja, hogy minden Spring Cloud-Azure függőség ugyanazt a verziót használja.

Az ehhez a BOM-hoz használt verzióról további információt a A Spring Cloud Azure melyik verzióját érdemes használnom című témakörben talál.

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 Azure szolgáltatásokkal növelik a Spring Boot-alkalmazások fejlesztését.

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

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

Név	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 Spring Securityvel való használatához készült kezdőcsomag.
spring-cloud-azure-starter-active-directory-b2c	A Azure Active Directory B2C és a Spring Security használatának kezdője.
spring-cloud-azure-starter-appconfiguration	A Azure App Configuration használatának kezdője.
spring-cloud-azure-starter-appconfiguration-config	A Azure App Configuration Config használatának kezdője.
spring-cloud-azure-starter-cosmos	A Azure Cosmos DB használatának kezdője.
spring-cloud-azure-starter-eventhubs	A Azure Event Hubs használatának kezdője.
spring-cloud-azure-starter-eventgrid	A Azure Event Grid használatának kezdője.
spring-cloud-azure-starter-keyvault	A Azure Key Vault használatának kezdője.
spring-cloud-azure-starter-keyvault-secrets	A Azure Key Vault Titkos kódok használatának kezdője.
spring-cloud-azure-starter-keyvault-jca	Az Azure Key Vault JCA használatához készült kezdőprojekt.
spring-cloud-azure-starter-keyvault-certificates	A Azure Key Vault-tanúsítványok használatának kezdője.
spring-cloud-azure-starter-servicebus	A Azure Service Bus használatának kezdője.
spring-cloud-azure-starter-servicebus-jms	A Azure Service Bus és A JMS használatának kezdője.
spring-cloud-azure-starter-storage	A Azure Storage használatának kezdője.
spring-cloud-azure-starter-storage-blob	A Azure Storage Blob használatának kezdője.
spring-cloud-azure-starter-storage-file-share	A Azure Storage fájlmegosztás használatának kezdője.
spring-cloud-azure-starter-storage-queue	A Azure Storage Queue használatának kezdője.
spring-cloud-azure-starter-actuator	A Spring Boot Actuator használatához való starter, amely éles üzemre kész funkciókat biztosít.

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

Név	Leírás
spring-cloud-azure-starter-data-cosmos	A Spring Data for Azure Cosmos DB használatának kezdője.

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

Név	Leírás
spring-cloud-azure-starter-data-redis-lettuce	Starter a Spring Data és az Azure Cache for Redis Lettuce klienssel való használatához.

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

Név	Leírás
spring-cloud-azure-starter-integration-eventhubs	A Azure Event Hubs és a Spring Integration használatának kezdője.
spring-cloud-azure-starter-integration-servicebus	A Azure Service Bus és a Spring Integration használatának kezdője.
spring-cloud-azure-starter-integration-storage-queue	A 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:

Név	Leírás
spring-cloud-azure-starter-stream-eventhubs	A Azure Event Hubs és a Spring Cloud Stream Binder használatának kezdője.
spring-cloud-azure-starter-stream-servicebus	A 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:

Név	Leírás
spring-cloud-azure-starter-jdbc-mysql	A Azure MySQLs és A JDBC Microsoft Entra hitelesítésen keresztüli használatának kezdője.

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

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

A Spring Cloud Azure tanulása

A használatot bemutató minták teljes listájáért lásd: Spring Cloud Azure Samples.

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 jelentős kiadás nagyobb biztonságot, kevesebb függőséget, a produkciós használat támogatását és egyebeket kínál.

Tipp

A 4.0-ra való migrálásról további információkért lásd a 4.0-s migrálási útmutatót.

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 BOM használatával.
• Kibővítettük az Azure-támogatást a Spring Initializr szolgáltatásban, hogy az a Kafka, az Event Hubs, az Azure Cache for Redis és az Azure App Configuration támogatására is kiterjedjen.
• 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 App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob és Storage Queue esetén.
• Spring-kódtárainkban továbbra is támogatjuk a mögöttes Azure SDK hitelesítési módszereit, például a Service Bus és az Event Hubs esetében az SAS-jogkivonattal, valamint a jogkivonat-hitelesítő adatokkal történő hitelesítést.
• 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óért lásd a Azure Identity client library for JavaDefaultAzureCredential szakaszát.
• Granuláris, erőforrásszintű hozzáférés-szabályozás (például Service Bus-üzenetsorokhoz) a biztonságirányítás javítása és az IT-szabályzatok betartásának elősegítése érdekében.
• Az Azure SDK-kliensek automatikus konfigurációjának kibővített lefedettsége révén további lehetőségek válnak elérhetővé a Springhez illeszkedő módon, mind a szinkron, mind az aszinkron használati esetekben.
• A Azure App Configuration, az Event Hubs, a Azure Cosmos DB, a Key Vault, a Storage Blob, a Storage Queue és a Storage File állapotjelzői hozzáadva.
• A Spring Cloud Sleuth minden HTTP-alapú Azure SDK-k támogatja.