Quickstart: Een Java Spring-app maken met Azure App Configuration

In deze quickstart neemt u Azure App Configuration op in een Java Spring-console-app om opslag en beheer van toepassingsinstellingen gescheiden van uw code te centraliseren.

Vereisten

• Azure-abonnement: u kunt een gratis abonnement nemen
• Een ondersteunde Java Development Kit (JDK) met versie 8.
• Apache Maven versie 3.0 of hoger.

Een App Configuration-archief maken

1. Als u een nieuw App Configuration-archief wilt maken, moet u zich eerst aanmelden bij de Azure-portal. Selecteer in de linkerbovenhoek van de startpagina de optie Een resource maken. Voer in het vak Marketplace doorzoeken App Configuration in en selecteer Invoeren.

   

2. Selecteer App Configuration in de zoekresultaten en selecteer vervolgens Maken.

   

3. Voer in het deelvenster App Configuration maken de volgende instellingen in:

   Instelling	Voorgestelde waarde	Beschrijving
   Abonnement	Uw abonnement	Selecteer het Azure-abonnement dat u wilt gebruiken om App Configuration te testen. Als uw account maar één abonnement heeft, wordt dit automatisch geselecteerd en wordt de lijst Abonnement niet weergegeven.
   Resourcegroep	AppConfigTestResources	Selecteer of maak een resourcegroep voor de resource van het App Configuration-archief. Deze groep is handig voor het ordenen van meerdere resources die u mogelijk op een bepaald moment wilt verwijderen door resourcegroep te verwijderen. Zie Resourcegroepen gebruiken om Azure-resources te beheren voor meer informatie.
   Resourcenaam	Wereldwijd unieke naam	Voer een unieke resourcenaam in voor de resource van het App Configuration-archief. De naam moet een tekenreeks zijn van 5 tot 50 tekens en mag alleen cijfers, letters en - bevatten. De naam mag niet beginnen of eindigen met -.
   Locatie	US - centraal	Gebruik Locatie om de geografische locatie op te geven waar het app-configuratiearchief wordt gehost. Voor de beste prestaties maakt u de resource in dezelfde regio als de andere onderdelen van uw toepassing.
   Prijscategorie	Gratis	Selecteer de gewenste prijscategorie. Ga voor meer informatie naar de pagina met prijzen voor App Configuration.

4. Selecteer Beoordelen en maken om de instellingen te valideren.

5. Selecteer Maken. De implementatie kan enkele minuten duren.

6. Als de implementatie is voltooid, gaat u naar de resource App Configuration. Selecteer Instellingen > Toegangssleutels. Noteer de verbindingsreeks van de primaire alleen-lezensleutel. U hebt de verbindingsreeks later nodig voor de configuratie van uw toepassing, zodat deze kan communiceren met het App Configuration-archief dat u hebt gemaakt.

7. Selecteer Configuratieverkenner > + Maken > Sleutel-waarde om de volgende sleutel-waardeparen toe te voegen:

   Sleutel	Waarde
   /application/config.message	Hello

   Laat Label en Inhoudstype nog even leeg.

8. Selecteer Toepassen.

Een Spring Boot-app maken

Gebruik de Spring Initializr om een nieuw Spring Boot-project te maken.

1. Blader naar https://start.spring.io/.

2. Geef de volgende opties op:

   • Genereer een Maven-project met Java.
   • Geef een Spring Boot-versie op van 2.0 of hoger.
   • Geef de namen voor Groep en Artefact voor uw toepassing op.
   • Voeg de Spring Web-afhankelijkheid toe.

3. Nadat u de vorige opties hebt opgegeven, selecteert u Project genereren. Wanneer u hierom wordt gevraagd, downloadt u het project naar een pad op uw lokale computer.

Verbinding maken met een App Configuration-archief

1. Nadat u de bestanden op uw lokale systeem hebt uitgepakt, is uw eenvoudige Spring Boot-toepassing gereed om te bewerken. Zoek het bestand pom.xml in de hoofdmap van uw app.

2. Open het bestand pom.xml in een teksteditor en voeg de starter Spring Cloud Azure Config toe aan de lijst van <dependencies>:

   Spring Boot 2.4

   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>azure-spring-cloud-appconfiguration-config</artifactId>
       <version>2.0.0</version>
   </dependency>
   

   Notitie

   Zie onze oude bibliotheek als u een oudere versie van Spring Boot wilt ondersteunen.

3. Maak een nieuw Java-bestand met de naam MessageProperties.java in de pakketmap van uw app. Voeg de volgende regels toe:

   package com.example.demo;
   
   import org.springframework.boot.context.properties.ConfigurationProperties;
   
   @ConfigurationProperties(prefix = "config")
   public class MessageProperties {
       private String message;
   
       public String getMessage() {
           return message;
       }
   
       public void setMessage(String message) {
           this.message = message;
       }
   }
   

4. Maak een nieuw Java-bestand met de naam HelloController.java in de pakketmap van uw app. Voeg de volgende regels toe:

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class HelloController {
       private final MessageProperties properties;
   
       public HelloController(MessageProperties properties) {
           this.properties = properties;
       }
   
       @GetMapping
       public String getMessage() {
           return "Message: " + properties.getMessage();
       }
   }
   

5. Open het Java-bestand van de hoofdtoepassing en voeg @EnableConfigurationProperties toe om deze functie in te schakelen.

   import org.springframework.boot.context.properties.EnableConfigurationProperties;
   
   @SpringBootApplication
   @EnableConfigurationProperties(MessageProperties.class)
   public class DemoApplication {
       public static void main(String[] args) {
           SpringApplication.run(DemoApplication.class, args);
       }
   }
   

6. Maak een nieuw bestand met de naam bootstrap.properties onder de resourcesmap van uw app en voeg de volgende regels toe aan het bestand. Vervang de voorbeeldwaarden door de juiste eigenschappen voor uw app-configuratiearchief.

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

7. Stel een omgevingsvariabele in met de naam APP_CONFIGURATION_CONNECTION_STRING en stel deze in op de toegangssleutel van het App Configuration-archief. Voer op de opdrachtregel de volgende opdracht uit en start de opdrachtprompt opnieuw op om de wijziging door te voeren:

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

   Als u Windows PowerShell gebruikt, voert u de volgende opdracht uit:

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

   Als u macOS of Linux gebruikt, voert u de volgende opdracht uit:

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

De app lokaal compileren en uitvoeren

1. Maak de Spring Boot-toepassing met Maven en voer deze uit; bijvoorbeeld:

   mvn clean package
   mvn spring-boot:run
   

2. Nadat uw toepassing wordt uitgevoerd, kunt u curl gebruiken om uw toepassing te testen; bijvoorbeeld:

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

   Er wordt een bericht weergegeven dat u zich in het app-configuratiearchief bevindt.

Resources opschonen

Als u niet door wilt gaan met de resources die in dit artikel zijn gemaakt, verwijdert u de resourcegroep die u hier hebt gemaakt om kosten te voorkomen.

1. Meld u aan bij de Azure-portal en selecteer Resourcegroepen.
2. Voer de naam van de resourcegroep in het vak Filteren op naam in.
3. Selecteer in de resultatenlijst de resourcegroepnaam om een overzicht te bekijken.
4. Selecteer Resourcegroep verwijderen.
5. U wordt gevraagd om het verwijderen van de resourcegroep te bevestigen. Voer de naam van de resourcegroep in ter bevestiging en selecteer Verwijderen.

Na enkele ogenblikken worden de resourcegroep en alle bijbehorende resources verwijderd.

Volgende stappen

In deze quickstart hebt u een nieuw app-configuratiearchief gemaakt en deze gebruikt met een Java Spring-app. Zie Spring op Azure voor meer informatie. Ga door naar de volgende zelfstudie voor meer informatie over het configureren van uw Java Spring-app om configuratie-instellingen dynamisch te vernieuwen.