البداية السريعة: إنشاء تطبيق Java Spring باستخدام تكوين تطبيق Azure

مقالة
04/12/2024

في هذه البداية السريعة، يمكنك دمج تكوين تطبيق Azure في تطبيق Java Spring لمركزية التخزين وإدارة إعدادات التطبيق بشكل منفصل عن التعليمة البرمجية الخاصة بك.

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.
متجر App Configuration. إنشاء متجر.
مجموعة Java Development Kit (JDK) مدعمة مع إصدار 11.
إصدار Apache Maven 3.0 أو أعلى.
تطبيق Spring Boot. إذا لم يكن لديك مشروع، فقم بإنشاء مشروع Maven باستخدام Spring Initializr. تأكد من تحديد Maven Project ، وضمن Dependencies، أضف تبعية Spring Web ، ثم حدد Java الإصدار 8 أو أعلى.

إضافة قيمة مفتاح

أضف قيمة المفتاح التالية إلى متجر App Configuration واترك Label و Content Type بقيمهما الافتراضية. لمزيد من المعلومات حول كيفية إضافة قيم المفاتيح إلى مخزن باستخدام مدخل Microsoft Azure أو CLI، انتقل إلى إنشاء قيمة مفتاح.

مفتاح	القيمة
/application/config.message	أهلا

الاتصال بمخزن تكوين التطبيق

الآن بعد أن أصبح لديك متجر App Configuration، يمكنك استخدام بداية Spring Cloud Azure Config لجعل تطبيقك يتصل بمخزن App Configuration الذي تقوم بإنشائه.

لتثبيت وحدة بدء تكوين Spring Cloud Azure، أضف التبعية التالية إلى ملف pom.xml الخاص بك:

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>

إنشاء التعليمة البرمجية للتطبيق

لاستخدام بداية تكوين Spring Cloud Azure للاتصال بتطبيقك بمخزن App Configuration الذي تقوم بإنشائه، قم بتكوين التطبيق باستخدام الخطوات التالية.

أنشئ ملف Java جديدا باسم MyProperties.java، وأضف الأسطر التالية:

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

أنشئ ملف Java جديدا باسم HelloController.java، وأضف الأسطر التالية:

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

في ملف Java للتطبيق الرئيسي، أضف @EnableConfigurationProperties لتمكين فئة خصائص تكوين MyProperties.java من أن تسري وتسجيلها مع حاوية 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);
    }
}

افتح اختبار الوحدة التي تم إنشاؤها تلقائيا وتحديثها لتعطيل Azure App Configuration، أو سيحاول التحميل من الخدمة عند تشغيل اختبارات الوحدة.

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

}

أنشئ ملفا جديدا باسم bootstrap.properties ضمن دليل الموارد لتطبيقك، وأضف السطر التالي إلى الملف.
```
spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}
```
قم بتعيين متغير بيئة يسمى APP_CONFIGURATION_CONNECTION_STRING، وقم بتعيينه إلى مفتاح الوصول إلى متجر App Configuration. في سطر الأوامر، قم بتشغيل الأمر التالي وأعد تشغيل موجه الأوامر للسماح بتنفيذ التغيير:
```
setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
```
إذا كنت تستخدم Windows PowerShell، فقم بإجراء الأمر التالي:
```
$Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
```
إذا كنت تستخدم macOS أو Linux، فقم بإجراء الأمر التالي:
```
export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
```

يوصى بإنشاء التطبيق وتشغيله محليًا

افتح موجه الأوامر إلى الدليل الجذر وقم بتشغيل الأوامر التالية لإنشاء تطبيق Spring Boot الخاص بك باستخدام Maven وتشغيله.
```
mvn clean package
mvn spring-boot:run
```
بعد تشغيل تطبيقك، استخدم curl لاختبار تطبيقك، على سبيل المثال:
```
curl -X GET http://localhost:8080/
```
تظهر الرسالة التي أدخلتها في مخزن تكوين التطبيقات.

تنظيف الموارد

إذا كنت لا تريد مواصلة استخدام الموارد التي تم إنشاؤها في هذه المقالة، يوصى بحذف مجموعة الموارد التي أنشأتها هنا لتجنب الرسوم.

هام

حذف مجموعة الموارد لا يمكن التراجع عنه. يتم حذف مجموعة الموارد وجميع الموارد المضمنة فيها نهائيًا. تأكد من عدم حذفك للموارد أو مجموعة المورد الخاطئة عن غير قصد. في حالة إنشاء الموارد لهذه المقالة داخل مجموعة موارد تشتمل على موارد أخرى تريد الاحتفاظ بها، احذف كل مورد على حدة من الجزء الخاص به بدلًا من حذف مجموعة الموارد.

سجل الدخول إلى مدخل Microsoft Azure، وحدد Resource groups.
في المربع تصفية حسب الاسم ، أدخل اسم مجموعة الموارد الخاصة بك.
في قائمة النتائج، حدد اسم مجموعة الموارد لاستعراض نظرة عامة.
حدد Delete resource group.
يُطلب منك تأكيد حذف مجموعة الموارد. أدخل اسم مجموعة الموارد للتأكيد وحدد "Delete".

بعد بضع لحظات، يتم حذف مجموعة الموارد وكافة مواردها.

الخطوات التالية

في هذه البداية السريعة، أنشأت متجرًا جديدًا لتكوين التطبيقات واستخدمته مع تطبيق Java Spring. لمزيد من المعلومات، راجع Spring on Azure. للمزيد من الأسئلة، راجع الوثائق المرجعية حيث تتضمن كل التفاصيل حول كيفية عمل مكتبة Spring Cloud Azure App Configuration. لمعرفة كيفية تمكين تطبيق Java Spring الخاص بك لتحديث إعدادات التكوين ديناميكيًا، تابع إلى البرنامج التعليمي التالي.

تمكين التكوين الديناميكي

Share via