Rövid útmutató: Java Spring-alkalmazás létrehozása Azure-alkalmazás konfigurációval

  • Cikk

Ebben a rövid útmutatóban Azure-alkalmazás Konfigurációt egy Java Spring-alkalmazásba építi be, hogy központosítsa az alkalmazásbeállítások tárolását és kezelését a kódtól elkülönítve.

Előfeltételek

Kulcs-érték hozzáadása

Adja hozzá a következő kulcsértéket az Alkalmazáskonfigurációs áruházhoz, és hagyja meg a címke és a tartalomtípus alapértelmezett értékeit. Ha többet szeretne tudni arról, hogyan adhat hozzá kulcsértékeket egy áruházhoz az Azure Portal vagy a parancssori felület használatával, lépjen a Kulcs-érték létrehozása elemre.

Kulcs Érték
/application/config.message Üdvözöljük

Csatlakozás alkalmazáskonfigurációs áruházba

Most, hogy már rendelkezik alkalmazáskonfigurációs tárral, használhatja a Spring Cloud Azure Config startert, hogy az alkalmazás kommunikáljon a létrehozott Alkalmazáskonfigurációs tárral.

A Spring Cloud Azure Config kezdőmodul telepítéséhez adja hozzá a következő függőséget a pom.xml fájlhoz:

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

Az alkalmazás kódolása

Ha a Spring Cloud Azure Config starter használatával szeretné, hogy az alkalmazás kommunikáljon a létrehozott Alkalmazáskonfigurációs tárral, az alábbi lépések végrehajtásával konfigurálja az alkalmazást.

  1. Hozzon létre egy MyProperties.java nevű új Java-fájlt, és adja hozzá a következő sorokat:

    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. Hozzon létre egy új Java-fájlt HelloController.java néven, és adja hozzá a következő sorokat:

    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. A fő alkalmazás Java-fájljában adja hozzá @EnableConfigurationProperties , hogy a MyProperties.java konfigurációs tulajdonságok osztálya érvénybe léphessen, és regisztrálja azt a Spring-tárolóban.

    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. Nyissa meg az automatikusan létrehozott egységtesztet és frissítést, hogy letiltsa Azure-alkalmazás konfigurációt, vagy megpróbál betöltődni a szolgáltatásból az egységtesztek futtatásakor.

    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. Hozzon létre egy bootstrap.properties nevű új fájlt az alkalmazás erőforráskönyvtárában, és adja hozzá a következő sort a fájlhoz.

    spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}

  6. Állítson be egy APP_CONFIGURATION_CONNECTION_STRING nevű környezeti változót, és állítsa be az App Configuration Store hozzáférési kulcsára. Futtassa a következő parancsot a parancssorban, és indítsa újra a parancssort a módosítás érvénybe lépésének engedélyezéséhez:

    setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"

    Windows PowerShell használata esetén futtassa a következő parancsot:

    $Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"

    MacOS vagy Linux használata esetén futtassa a következő parancsot:

    export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'

Az alkalmazás helyi létrehozása és futtatása

  1. Nyissa meg a parancssort a gyökérkönyvtárban, és futtassa az alábbi parancsokat a Spring Boot-alkalmazás Mavennel való létrehozásához és futtatásához.

    mvn clean package
mvn spring-boot:run

  2. Az alkalmazás futtatása után a curl használatával tesztelheti az alkalmazást, például:

    curl -X GET http://localhost:8080/

    Az Alkalmazáskonfigurációs áruházban megadott üzenet jelenik meg.

Az erőforrások eltávolítása

Ha nem szeretné folytatni a cikkben létrehozott erőforrások használatát, törölje az itt létrehozott erőforráscsoportot a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne lévő összes erőforrás véglegesen törlődik. Győződjön meg arról, hogy nem véletlenül törli a rossz erőforráscsoportot vagy erőforrásokat. Ha a cikk erőforrásait olyan erőforráscsoporton belül hozta létre, amely más megtartani kívánt erőforrásokat tartalmaz, törölje az egyes erőforrásokat a megfelelő panelről az erőforráscsoport törlése helyett.

  1. Jelentkezzen be az Azure Portalra, és válassza ki az Erőforráscsoportokat.
  2. A Szűrés név szerint mezőbe írja be az erőforráscsoport nevét.
  3. Az eredménylistában válassza ki az erőforráscsoport nevét az áttekintés megtekintéséhez.
  4. Válassza az Erőforráscsoport törlése elemet.
  5. A rendszer az erőforráscsoport törlésének megerősítését kéri. Adja meg a megerősítéshez az erőforráscsoport nevét, és válassza a Törlés lehetőséget.

Néhány pillanat múlva az erőforráscsoport és annak összes erőforrása törlődik.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy új alkalmazáskonfigurációs áruházat, amelyet egy Java Spring-alkalmazással használt. További információ: Spring on Azure. További kérdésekért tekintse meg a referenciadokumentációt, amely tartalmazza a Spring Cloud Azure-alkalmazás Konfigurációs kódtár működésével kapcsolatos összes részletet. Ha szeretné megtudni, hogyan engedélyezheti a Java Spring-alkalmazást a konfigurációs beállítások dinamikus frissítéséhez, folytassa a következő oktatóanyagban.

Dinamikus konfiguráció engedélyezése