Mulai Cepat: Membuat aplikasi Java Spring dengan Azure App Configuration

Artikel
04/13/2024

Dalam panduan mulai cepat ini, Anda memasukkan Azure App Configuration ke dalam aplikasi Java Spring untuk memusatkan penyimpanan dan pengelolaan pengaturan aplikasi yang terpisah dari kode Anda.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun gratis.
Penyimpanan App Configuration. Buat toko.
Java Development Kit (JDK) yang didukung dengan versi 11.
Apache Maven versi 3.0 atau lebih tinggi.
Aplikasi Spring Boot. Jika Anda tidak memilikinya, buat proyek Maven dengan Spring Initializr. Pastikan untuk memilih Proyek Maven dan, di bawah Dependensi, tambahkan dependensi Spring Web , lalu pilih Java versi 8 atau yang lebih tinggi.

Menambahkan nilai kunci

Tambahkan nilai kunci berikut ke penyimpanan App Configuration dan biarkan Label dan Tipe Konten dengan nilai defaultnya. Untuk informasi selengkapnya tentang cara menambahkan nilai kunci ke penyimpanan menggunakan portal Azure atau CLI, buka Membuat nilai kunci.

Tombol	Nilai
/application/config.message	Halo

Tersambung ke Penyimpanan App Configuration

Sekarang setelah Anda memiliki penyimpanan App Configuration, Anda dapat menggunakan starter Spring Cloud Azure Config agar aplikasi Anda berkomunikasi dengan penyimpanan App Configuration yang Anda buat.

Untuk menginstal modul pemula Spring Cloud Azure Config, tambahkan dependensi berikut ke file pom.xml Anda:

Spring Boot 3
Spring Boot 2

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

<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>4.14.0</version>
        <type>pom</type>
        <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Kodekan aplikasi

Untuk menggunakan starter Spring Cloud Azure Config agar aplikasi Anda berkomunikasi dengan penyimpanan App Configuration yang Anda buat, konfigurasikan aplikasi dengan menggunakan langkah-langkah berikut.

Buat file Java baru bernama MyProperties.java, dan tambahkan baris berikut:

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

Buat file Java baru bernama HelloController.java, dan tambahkan baris berikut:

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

Dalam file Java aplikasi utama, tambahkan @EnableConfigurationProperties untuk mengaktifkan kelas properti konfigurasi MyProperties.java agar berlaku dan mendaftarkannya dengan kontainer 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);
    }
}

Buka pengujian dan pembaruan unit yang dibuat secara otomatis untuk menonaktifkan Azure App Configuration, atau akan mencoba memuat dari layanan saat menjalankan pengujian unit.

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

}

Buat file baru bernama bootstrap.properties di bawah direktori sumber daya aplikasi Anda, dan tambahkan baris berikut ke file.
```
spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}
```
Set sebuah variabel lingkungan bernama APP_CONFIGURATION_CONNECTION_STRING, dan atur ke kunci akses ke store App Configuration Anda. Di baris perintah, jalankan perintah berikut dan hidupkan ulang perintah agar perubahan berlaku:
```
setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
```
Jika Anda menggunakan PowerShell Windows, jalankan perintah berikut:
```
$Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
```
Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut:
```
export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
```

Membangun dan menjalankan aplikasi secara lokal

Buka perintah ke direktori akar dan jalankan perintah berikut untuk membangun aplikasi Spring Boot Anda dengan Maven dan menjalankannya.
```
mvn clean package
mvn spring-boot:run
```
Setelah aplikasi Anda berjalan, gunakan curl untuk menguji aplikasi Anda, misalnya:
```
curl -X GET http://localhost:8080/
```
Anda melihat pesan yang dimasukkan di penyimpanan Azure App Configuration.

Membersihkan sumber daya

Jika Anda tidak ingin terus menggunakan sumber daya yang dibuat dalam artikel ini, hapus grup sumber daya yang Anda buat di sini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak bisa dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat sumber daya untuk artikel ini dalam grup sumber daya yang ada yang berisi sumber daya lain yang ingin disimpan, hapus setiap sumber daya satu per satu dari panelnya masing-masing, bukan menghapus grup sumber daya.

Masuk ke portal Azure, lalu pilih Grup sumber daya.
Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
Pilih Hapus grup sumber daya.
Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Masukkan nama grup sumber daya Anda untuk mengonfirmasi, dan pilih Hapus.

Setelah beberapa saat, grup sumber daya dan semua sumber dayanya akan dihapus.

Langkah berikutnya

Dalam panduan mulai cepat ini, Anda membuat store App Configuration baru dan menggunakannya dengan aplikasi Java Spring. Untuk informasi selengkapnya, lihat Spring di Azure. Untuk pertanyaan lebih lanjut, lihat dokumentasi referensi, dokumentasi ini berisi semua detail tentang cara kerja pustaka Spring Cloud Azure App Configuration. Untuk mempelajari cara mengaktifkan aplikasi Java Spring Anda guna me-refresh pengaturan konfigurasi secara dinamis, lanjutkan ke tutorial berikutnya.

Mengaktifkan konfigurasi dinamis

Bagikan melalui