Hızlı Başlangıç: Azure Uygulaması Yapılandırması ile Java Spring uygulaması oluşturma

Makale
04/13/2024

Bu hızlı başlangıçta, kodunuzdan ayrı olarak uygulama ayarlarının depolanmasını ve yönetimini merkezileştirmek için Azure Uygulaması Yapılandırması'nı bir Java Spring uygulamasına ekleyeceksiniz.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir tane oluşturun.
bir Uygulama Yapılandırması mağazası. Mağaza oluşturma.
Sürüm 11 ile desteklenen bir Java Development Kit (JDK).
Apache Maven sürüm 3.0 veya üzeri.
Spring Boot uygulaması. Yoksa Spring Initializr ile bir Maven projesi oluşturun. Maven Projesi'ni seçtiğinizden ve Bağımlılıklar'ın altında Spring Web bağımlılığını eklediğinizden ve ardından Java sürüm 8 veya üzerini seçtiğinizden emin olun.

Anahtar-değer ekleme

Uygulama Yapılandırması deposuna aşağıdaki anahtar değerini ekleyin ve Etiket ve İçerik Türü değerlerini varsayılan değerleriyle bırakın. Azure portalını veya CLI'yı kullanarak bir depoya anahtar-değer ekleme hakkında daha fazla bilgi için Anahtar-değer oluşturma bölümüne gidin.

Anahtar	Değer
/application/config.message	Merhaba

Uygulama Yapılandırması mağazasına Bağlan

Artık bir Uygulama Yapılandırması mağazanız olduğuna göre, uygulamanızın oluşturduğunuz Uygulama Yapılandırması deposuyla iletişim kurmasını sağlamak için Spring Cloud Azure Config başlatıcısını kullanabilirsiniz.

Spring Cloud Azure Config başlangıç modülünü yüklemek için pom.xml dosyanıza aşağıdaki bağımlılığı ekleyin:

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>

Uygulamayı kodlama

Uygulamanızın oluşturduğunuz Uygulama Yapılandırması deposuyla iletişim kurması için Spring Cloud Azure Config başlatıcısını kullanmak için aşağıdaki adımları kullanarak uygulamayı yapılandırın.

MyProperties.java adlı yeni bir Java dosyası oluşturun ve aşağıdaki satırları ekleyin:

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

HelloController.java adlı yeni bir Java dosyası oluşturun ve aşağıdaki satırları ekleyin:

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

Ana uygulama Java dosyasında, MyProperties.java yapılandırma özellikleri sınıfının etkili olmasını ve Spring kapsayıcısına kaydetmesini sağlamak için öğesini ekleyin@EnableConfigurationProperties.

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

otomatik olarak oluşturulan birim testini açın ve Azure Uygulaması Yapılandırması'nı devre dışı bırakmak için güncelleştirin; aksi takdirde birim testleri çalıştırılırken hizmetten yüklenmeye çalışılır.

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

}

Uygulamanızın resources dizininde bootstrap.properties adlı yeni bir dosya oluşturun ve dosyaya aşağıdaki satırı ekleyin.
```
spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}
```
APP_CONFIGURATION_CONNECTION_STRING adlı bir ortam değişkeni ayarlayın ve bunu Uygulama Yapılandırması deponuzun erişim anahtarına ayarlayın. Komut satırında aşağıdaki komutu çalıştırın ve değişikliğin etkili olması için komut istemini yeniden başlatın:
```
setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
```
Windows PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:
```
$Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
```
macOS veya Linux kullanıyorsanız aşağıdaki komutu çalıştırın:
```
export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
```

Uygulamayı yerel olarak derleme ve çalıştırma

Kök dizinde komut istemini açın ve Maven ile Spring Boot uygulamanızı derlemek ve çalıştırmak için aşağıdaki komutları çalıştırın.
```
mvn clean package
mvn spring-boot:run
```
Uygulamanız çalıştırıldıktan sonra curl kullanarak uygulamanızı test edin, örneğin:
```
curl -X GET http://localhost:8080/
```
Uygulama Yapılandırması mağazasına girdiğiniz iletiyi görürsünüz.

Kaynakları temizleme

Bu makalede oluşturulan kaynakları kullanmaya devam etmek istemiyorsanız ücretlerden kaçınmak için burada oluşturduğunuz kaynak grubunu silin.

Önemli

Silinen kaynak grupları geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun. Bu makalenin kaynaklarını, saklamak istediğiniz diğer kaynakları içeren bir kaynak grubu içinde oluşturduysanız, kaynak grubunu silmek yerine her kaynağı ilgili bölmeden tek tek silin.

Azure portalında oturum açın ve Kaynak grupları'nı seçin.
Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
Genel bir bakış görmek için sonuç listesinde kaynak grubu adını seçin.
Kaynak grubunu sil'i seçin.
Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını girin ve Sil'i seçin.

Birkaç dakika sonra kaynak grubu ve tüm kaynakları silinir.

Sonraki adımlar

Bu hızlı başlangıçta yeni bir Uygulama Yapılandırması deposu oluşturdunuz ve bunu bir Java Spring uygulamasıyla kullandınız. Daha fazla bilgi için bkz . Azure'da Spring. Daha fazla soru için başvuru belgelerine bakın; Spring Cloud Azure Uygulaması Configuration kitaplığının nasıl çalıştığıyla ilgili tüm ayrıntılara sahiptir. Java Spring uygulamanızın yapılandırma ayarlarını dinamik olarak yenilemesini nasıl etkinleştireceğinizi öğrenmek için sonraki öğreticiye geçin.

Dinamik yapılandırmayı etkinleştirme

Share via