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

  • Článek

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

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.

  1. 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;
    }
}

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

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

  4. 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() {
    }

}

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

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

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

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

  1. Přihlaste se k webu Azure Portal a vyberte skupiny prostředků.
  2. Do pole Filtrovat podle názvu zadejte název vaší skupiny prostředků.
  3. V seznamu výsledků vyberte název skupiny prostředků, abyste zobrazili přehled.
  4. Vyberte Odstranit skupinu prostředků.
  5. 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