Rychlý start: Vytvoření aplikace Java Spring s konfigurací Aplikace Azure
V tomto rychlém startu začleníte Aplikace Azure Configuration do aplikace Java Spring, která centralizuje úložiště a správu nastavení aplikací odděleně od kódu.
Požadavky
- Účet Azure s aktivním předplatným. Vytvořte si ho zdarma.
- App Configuration Store. Vytvořte úložiště.
- Podporovaná sada Java Development Kit (JDK) s verzí 11.
- Apache Maven verze 3.0 nebo novější
- Aplikace Spring Boot. Pokud ho nemáte, vytvořte projekt Maven pomocí aplikace Spring Initializr. Nezapomeňte vybrat projekt Maven a v části Závislosti přidejte závislost Spring Web a pak vyberte Javu verze 8 nebo vyšší.
Přidání hodnoty klíče
Přidejte do obchodu App Configuration následující klíč-hodnota a ponechte popisek a typ obsahu s výchozími hodnotami. Další informace o tom, jak přidat hodnoty klíčů do úložiště pomocí webu Azure Portal nebo rozhraní příkazového řádku, najdete v tématu Vytvoření hodnoty klíče.
Key | Hodnota |
---|---|
/application/config.message | Hello (Nazdar) |
Připojení do App Configuration Storu
Teď, když máte úložiště App Configuration, můžete použít úvodní sadu Spring Cloud Azure Config k tomu, aby vaše aplikace komunikovaly s úložištěm App Configuration, který vytvoříte.
Pokud chcete nainstalovat úvodní modul Spring Cloud Azure Config, přidejte do souboru pom.xml následující závislost:
<dependency>
<groupId>com.azure.spring</groupId>
<artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
</dependency>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.azure.spring</groupId>
<artifactId>spring-cloud-azure-dependencies</artifactId>
<version>5.8.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
Vytvoření kódu aplikace
Pokud chcete pomocí úvodní sady Spring Cloud Azure Config zajistit, aby vaše aplikace komunikovaly s vámi vytvořeným obchodem App Configuration Store, nakonfigurujte aplikaci pomocí následujícího postupu.
Vytvořte nový soubor Java s názvem MyProperties.java a přidejte následující řádky:
import org.springframework.boot.context.properties.ConfigurationProperties; @ConfigurationProperties(prefix = "config") public class MyProperties { private String message; public String getMessage() { return message; } public void setMessage(String message) { this.message = message; } }
Vytvořte nový soubor Java s názvem HelloController.java a přidejte následující řádky:
import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloController { private final MyProperties properties; public HelloController(MyProperties properties) { this.properties = properties; } @GetMapping public String getMessage() { return "Message: " + properties.getMessage(); } }
V souboru Java hlavní aplikace přidejte
@EnableConfigurationProperties
, aby se třída vlastností konfigurace MyProperties.java projevila a zaregistrovala ji v kontejneru Spring.import org.springframework.boot.context.properties.EnableConfigurationProperties; @SpringBootApplication @EnableConfigurationProperties(MyProperties.class) public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }
Otevřete automaticky vygenerovaný test jednotek a aktualizujte a zakažte konfiguraci Aplikace Azure nebo se pokusí načíst ze služby při spouštění testů jednotek.
import org.junit.jupiter.api.Test; import org.springframework.boot.test.context.SpringBootTest; @SpringBootTest(properties = "spring.cloud.azure.appconfiguration.enabled=false") class DemoApplicationTests { @Test void contextLoads() { } }
V adresáři prostředků aplikace vytvořte nový soubor s názvem bootstrap.properties a do souboru přidejte následující řádek.
spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}
Nastavte proměnnou prostředí s názvem APP_CONFIGURATION_CONNECTION_STRING a nastavte ji na přístupový klíč k vašemu App Configuration Storu. Na příkazovém řádku spusťte následující příkaz a restartujte příkazový řádek, aby se změna projevila:
setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
Pokud používáte Windows PowerShell, spusťte následující příkaz:
$Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
Pokud používáte macOS nebo Linux, spusťte následující příkaz:
export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
Sestavení a místní spuštění aplikace
Otevřete příkazový řádek do kořenového adresáře a spuštěním následujících příkazů sestavte aplikaci Spring Boot pomocí Mavenu a spusťte ji.
mvn clean package mvn spring-boot:run
Po spuštění aplikace použijte curl k otestování aplikace, například:
curl -X GET http://localhost:8080/
Zobrazí se zpráva, kterou jste zadali v App Configuration Storu.
Vyčištění prostředků
Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste se vyhnuli poplatkům.
Důležité
Odstranění skupiny prostředků je nevratné. Skupina prostředků a všechny prostředky v ní se trvale odstraní. Ujistěte se, že omylem neodstraníte nesprávnou skupinu prostředků nebo prostředky. Pokud jste vytvořili prostředky pro tento článek ve skupině prostředků, která obsahuje další prostředky, které chcete zachovat, odstraňte jednotlivé prostředky z příslušného podokna místo odstranění skupiny prostředků.
- Přihlaste se k webu Azure Portal a vyberte skupiny prostředků.
- Do pole Filtrovat podle názvu zadejte název vaší skupiny prostředků.
- V seznamu výsledků vyberte název skupiny prostředků, abyste zobrazili přehled.
- Vyberte Odstranit skupinu prostředků.
- Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte název skupiny prostředků a vyberte Odstranit.
Po chvíli se skupina prostředků a všechny její prostředky odstraní.
Další kroky
V tomto rychlém startu jste vytvořili nový obchod App Configuration a použili ho s aplikací Java Spring. Další informace najdete v tématu Spring v Azure. Další dotazy najdete v referenční dokumentaci, kde najdete všechny podrobnosti o tom, jak knihovna Spring Cloud Aplikace Azure Configuration library funguje. Pokud chcete zjistit, jak povolit aplikaci Java Spring dynamicky aktualizovat nastavení konfigurace, pokračujte dalším kurzem.