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

في هذه البداية السريعة، يمكنك دمج تكوين تطبيق 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 الخاص بك:

<dependencies>
    ...
    <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-dependencies</artifactId>
        <version>6.0.0</version>
        <type>pom</type>
        <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

بشكل افتراضي، تتصل المكتبة بمخزن App Configuration بواسطة Managed Identity. اتبع الإرشادات لتعيين بيانات الاعتماد الخاصة بك دور قارئ بيانات تكوين التطبيق. تأكد من السماح بوقت كاف للإذن للنشر قبل تشغيل التطبيق الخاص بك. ثم أنشئ ملفا جديدا باسم AppConfigCredential.java وأضف الأسطر التالية:
```
import org.springframework.stereotype.Component;

import com.azure.data.appconfiguration.ConfigurationClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.spring.cloud.appconfiguration.config.ConfigurationClientCustomizer;

@Component
public class AppConfigCredential implements ConfigurationClientCustomizer {

    @Override
    public void customize(ConfigurationClientBuilder builder, String endpoint) {
        builder.credential(new DefaultAzureCredentialBuilder().build());
    }
}
```
ملاحظة

بالإضافة إلى ذلك، يمكنك استخدام مصادقة Spring Cloud Azure لتوفير معلومات المصادقة. عند المصادقة مع تكوين Azure Spring، فإنه يتيح استخدام نفس المصادقة لجميع مكتبات Azure Spring.
ثم قم بإنشاء تكوين Bootstrap Configuration، عن طريق إنشاء spring.factories ملف ضمن resources/META-INF الدليل وإضافة الأسطر التالية والتحديث com.example.MyApplication باسم التطبيق والحزمة:
```
org.springframework.cloud.bootstrap.BootstrapConfiguration=\
com.example.MyApplication
```
قم بإنشاء ملف جديد باسم application.properties ضمن دليل الموارد لتطبيقك، وأضف السطر التالي إلى الملف.
```
spring.config.import=azureAppConfiguration
spring.cloud.azure.appconfiguration.stores[0].endpoint= ${APP_CONFIGURATION_ENDPOINT}
```

القراءة من متجر App Configuration

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

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

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@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.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @Autowired
    private MyProperties properties; 

    @GetMapping
    public String getMessage() {
        return "Message: " + properties.getMessage();
    }
}

افتح اختبار الوحدة التي تم إنشاؤها تلقائيا وتحديثها لتعطيل 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() {
    }

}

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

قم بتعيين متغير بيئة يسمى APP_CONFIGURATION_ENDPOINT، وقم بتعيينه إلى مفتاح الوصول إلى متجر App Configuration. في سطر الأوامر، قم بتشغيل الأمر التالي وأعد تشغيل موجه الأوامر للسماح بتنفيذ التغيير:
```
setx APP_CONFIGURATION_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
إذا كنت تستخدم Windows PowerShell، فقم بإجراء الأمر التالي:
```
$Env:APP_CONFIGURATION_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
إذا كنت تستخدم macOS أو Linux، فقم بإجراء الأمر التالي:
```
export APP_CONFIGURATION_ENDPOINT='<endpoint-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 الخاص بك لتحديث إعدادات التكوين ديناميكيًا، تابع إلى البرنامج التعليمي التالي.

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

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2025-08-25