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

A támogatott verziókról további információt a Verzióleképezés cí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.
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.

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>7.1.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 "4.0.1"
  }
  
  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.7"
  }
  
  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 a Spring Boot 4.0.x-et használja, mindenképpen állítsa a spring-cloud-azure-dependencies verziót 7.1.0 értékre.

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

Ha Spring Boot 3.1.x-3.5.x verziót használ, mindenképpen állítsa be a verziótspring-cloud-azure-dependencies.5.25.0

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 anyagjegyzékhez használt verzióval kapcsolatos további információkért lásd: A Spring Cloud Azure É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 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 spring security Microsoft Entra ID használatának kezdője.
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 Spring Cloud Azure indítócsomag - Key Vault)	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ának kezdője.
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á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	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	A Spring Data és a Azure Cache for Redis a Saláta használata 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	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 mutató minták teljes listáját a Felhő Azure minták című témakörben találja.

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 support Spring Initializr a Kafka, az Event Hubs, a Azure Cache for Redis és a 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 Azure App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob és Storage Queue esetén.
• A Spring-kódtárak mögöttes Azure SDK, például az SAS-jogkivonat és a jogkivonat hitelesítő adatainak Service Bus és Event Hubs használatával történő hitelesítésének folyamatos támogatása.
• 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ó: DefaultAzureCredentialAzure Identity client library for Java.
• Részletes hozzáférés-vezérlés erőforrásszinten (például Service Bus üzenetsoron) a jobb biztonság szabályozása és az informatikai szabályzatok betartása érdekében.
• A spring-idiomatikus módon elérhető további lehetőségek a Azure SDK ügyfelek automatikus konfigurációs lefedettségének továbbfejlesztett, szinkron és aszinkron forgatókönyvekhez való jobb automatikus konfigurálásával.
• 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 SDKs támogatja.