Spring Cloud Azure fejlesztői útmutató

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 Mappingcímű témakörben talál.

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

Borravaló

A 4.0-ra való migrálásról további információt a 4.0-smigrálási útmutatójá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 BOM használatával.
• Kibővített Azure-támogatás Spring Initializr a Kafka, az Event Hubs, az Azure Cache for Redis és az Azure App 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 az Azure App Configuration, az Event Hubs, a Service Bus, az Azure Cosmos DB, a Key Vault, a Storage Blob és a Storage Queue szolgáltatáshoz.
• 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ót a Java Azure Identity ügyfélkódtárának DefaultAzureCredential szakaszában talál.
• 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.
• Az Azure SDK-ügyfelek automatikus konfigurációs lefedettségének továbbfejlesztett, spring-idiomatikus módon elérhető lehetőségei szinkron és aszinkron forgatókönyvek esetén is.
• Az Azure App Configuration, 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-smigrálási útmutatójában talál.

Kezdetekhez

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 verziószámozás delegálva van az anyagjegyzékbe.

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

A Gradle használatával az alábbi módokon importálhatja a spring-cloud-azure-dependencies anyagjegyzéket:

• 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 "3.2.O"
  }
  
  dependencies {
      implementation(platform(SpringBootPlugin.BOM_COORDINATES))
      implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}"))
  }
  

• Használja a io.spring.dependency-management beépülő modult, és importálja a BOM-t a dependencyManagement, ahogyan az alábbi példában látható:

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

További információ: Spring Boot Gradle beépülő modul referencia-útmutatója.

Jegyzet

Ha Spring Boot 3.0.x-3.4.x verziót használ, mindenképpen állítsa be a spring-cloud-azure-dependencies verziót 5.23.0.

Ha Spring Boot 2.x-et használ, ügyeljen arra, hogy a spring-cloud-azure-dependencies verzió 4.20.0legyen.

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.

A BOM-hoz használt verzióval kapcsolatos további információkért lásd a Spring Cloud Azure melyik verzióját használjam.

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 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 csoportban 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 é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	Az Azure App 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 Spring Cloud Azure indítócsomag - Key Vault)	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:

Név	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:

Név	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:

Név	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:

Név	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:

Név	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.

A Spring Cloud Azure tanulása

A használatot mutató minták teljes listáját a Spring Cloud Azure-mintákcímű témakörben találja.