Rychlý start: Vytvoření aplikace Java Spring s konfigurací Aplikace Azure

Článek
12/12/2024

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í ke službě App Configuration Store

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.18.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);
    }
}

Použijete DefaultAzureCredential k ověření ve službě App Configuration Store. Postupujte podle pokynů a přiřaďte své přihlašovací údaje roli Čtenář dat konfigurace aplikace. Před spuštěním aplikace nezapomeňte povolit dostatek času, než se oprávnění rozšíří. Vytvořte nový soubor s názvem AppConfigCredential.java a přidejte následující řádky:

import org.springframework.stereotype.Component;

import com.azure.data.appconfiguration.ConfigurationClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.spring.cloud.appconfiguration.config.ConfigurationClientCustomizer;

@Component
public class AppConfigCredential implements ConfigurationClientCustomizer {

    @Override
    public void customize(ConfigurationClientBuilder builder, String endpoint) {
        builder.credential(new DefaultAzureCredentialBuilder().build());
    }
}

Potom vytvořte konfiguraci Bootstrap Configuration vytvořením spring.factories souboru v resources/META-INF adresáři a přidejte následující řádky a aktualizujte com.example.MyApplication ho názvem a balíčkem aplikace:
```
org.springframework.cloud.bootstrap.BootstrapConfiguration=\
com.example.MyApplication
```

Otevřete automaticky vygenerovaný test jednotek a aktualizujte 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].endpoint= ${APP_CONFIGURATION_ENDPOINT}
```
Nastavte proměnnou prostředí s názvem APP_CONFIGURATION_ENDPOINT 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_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
Pokud používáte Windows PowerShell, spusťte následující příkaz:
```
$Env:APP_CONFIGURATION_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
Pokud používáte macOS nebo Linux, spusťte následující příkaz:
```
export APP_CONFIGURATION_ENDPOINT='<endpoint-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.

Povolení dynamické konfigurace

Sdílet prostřednictvím