السابق

التالي

إنشاء دالة Azure باستخدام نموذج Maven الأصلي

مكتمل

توفر نماذج Maven الأصلية للمطورين اللبنات الأساسية لإنشاء المشروعات. هناك العديد من النماذج الأصلية المتاحة، ويوفر كل شكل أصلي مختلف وظائف محددة يمكن للمطورين استخدامها في تطوير التطبيقات الخاصة بهم. مع مراعاة ذلك، أصدرت azure-functions-archetype Microsoft النموذج الأصلي، لدعم العمل مع Azure Functions.

في هذه الوحدة، ستتعلم ما تحتاج إليه لبدء استخدام نماذج Maven الأصلية. ترى كيفية استخدام azure-functions-archetype مع Maven، وتستكشف إنشاء نموذج دالة.

البدء مع نماذج Maven الأصلية وAzure Functions

استخدام Maven لبناء تطبيقات ويب Java تلقائياً

Maven هي أداة بناء Java الأكثر استخداما لبناء وإدارة أي مشروع يستند إلى Java. يساعد على تبسيط العمليات لكيفية إنشاء المطورين لمشاريع Java من خلال توفير طريقة قياسية لبناء المشاريع. يتضمن هذا المعيار، تعريفا واضحا لما يتكون من المشروع، وطريقة سهلة لنشر معلومات المشروع، وطريقة لمشاركة التقارير المشتركة عبر العديد من المشاريع. تتمثّل أهداف Maven فيما يلي:

• تسهيل عملية البناء
• الانتقال إلى الميزات الجديدة بصورة شفافة
• توفير نظام بناء موحد
• تطبيق الإرشادات المتعلقة بأفضل الممارسات في التطوير

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

إشعار

إذا كنت تستخدم حساب Azure الشخصي الخاص بك بدلاً من Cloud Shell في بيئة الاختبار المعزولة للتعلم، فستحتاج إلى التأكد من تثبيت العناصر التالية:

عنصر	‏‏الإصدار
Java JDK	1.8
Maven	3.0 أو أعلى
أدوات Azure Functions الأساسية	2.7 أو أعلى

ما بنية وظيفة Maven الإضافية

Maven هو إطار عمل لتنفيذ سلسلة من المكونات الإضافية. يحتوي كل مكون إضافي من Maven على سلوكيات محددة مدفوعة بالمعلمات التي يوفرها المطورون. على سبيل المثال، تتحكم الوظائف الإضافية في ما إذا كان سيتم إنشاء ملف Web Application Archive (WAR) أم ملف Java Archive (JAR)، وكيفية تحويل تعليمتك البرمجية برمجياً، وتشغيل اختبارات الوحدة. يُمكن تنفيذ أي إجراء تقريباً من خلال وظيفة Maven الإضافية.

تحدد المكونات الإضافية المهام على أنها أهداف، ويمكن أن يكون للمكون الإضافي عدة أهداف. على سبيل المثال، تسعى وظيفة Maven Clean الإضافية خلف هدف واحد، وهو إزالة الدليل المستهدف لمشروعك.

ملف نموذج كائن المشروع في Maven (POM) هو ملف تكوين يستند إلى XML يُشكل جزءاً من ملفات مشروع تطبيقك. تحمل ملفات POM اسم pom.xml، وهي تحتوي على تعريفات لكل من الوظائف الإضافية التي يحتاجها تطبيقك، والتي تشمل المعلمات المطلوبة لكل وظيفة إضافية.

عند إنشاء دالة Azure أو نشرها باستخدام Maven، تحتاج إلى التأكد من تضمين في azure-functions-maven-plugin ملف pom.xml. تتوفر تفاصيل إضافة هذه الوظيفة الإضافية إلى ملف pom.xml الخاص بك في قسم استخدام النماذج الأصلية بشكل تفاعلي من هذه الوحدة.

ما نماذج Maven الأصلية؟

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

استخدام النماذج الأصلية بشكل تفاعلي

لاستخدام نموذج Microsoft الأصلي لـ Azure Functions لإنشاء مشروع، يُمكنك استخدام الأمر mvn archetype:generate، الذي يدخل في الوضع التفاعلي الذي يطالبك بالقيم. على سبيل المثال:

mvn archetype:generate \
  -DarchetypeGroupId="com.microsoft.azure" \
  -DarchetypeArtifactId="azure-functions-archetype"

المكان:

المعلمة	‏‏الوصف‬
archetype:generate	لتوجيه Maven إلى إنشاء مشروع من نموذج أصلي.
-DarchetypeGroupId	لتحديد مُعرِّف المجموعة للنموذج الأصلي، والذي يكون منشئ النموذج الأصلي في العادة.
-DarchetypeArtifactId	لتحديد مُعرِّف النموذج الأصلي، وهو النموذج الأصلي لـ Azure Functions في هذا المثال.
-DjavaVersion=8	استخدم -DjavaVersion=11 إذا كنت تريد تشغيل دالاتك على Java 11.

عند إنشاء مشروع باستخدام mvn archetype:generate الأمر ، ينشئ Maven مجلدا للمشروع، ويحتوي المجلد الجذر على ملف pom.xml الخاص بمشروعك.

إذا قمت بتحديد azure-functions-archetype عند تشغيل mvn archetype:generate الأمر، يحتوي ملف pom.xml الخاص بمشروعك على قسم يحتوي على المعلومات الضرورية للمكون الإضافي Azure Functions. على سبيل المثال:

<project>
  . . .
  <build>
    . . .
    <plugins>
      . . .
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>azure-functions-maven-plugin</artifactId>
            <version>${azure.functions.maven.plugin.version}</version>
            <configuration>
                <!-- function app name -->
                <appName>${functionAppName}</appName>
                <!-- function app resource group -->
                <resourceGroup>java-functions-group</resourceGroup>
                <!-- function app service plan name -->
                <appServicePlanName>java-functions-app-service-plan</appServicePlanName>
             . . .
         </configuration>
      </plugin>
    </plugins>
  </build>
</project>

إنشاء دالة أساسية باستخدام Azure Cloud Shell

يُمكنك إنشاء دالة Azure أساسية من داخل Azure Cloud Shell مباشرة. تضمن Azure إتاحة جميع المكتبات المطلوبة لإنشاء مشروعك وبنائه، بما في ذلك وظيفة Maven الإضافية وAzure Functions.

توضح الخطوات التالية العملية الأساسية لإنشاء دالة Azure باستخدام Cloud Shell:

1. من Cloud Shell، قم بتشغيل mvn archetype:generate الأمر وحدد azure-functions-archetype.

2. يطالبك Maven بإدخال groupId لتطبيقك، الذي تقوم بإدخاله بتنسيق اسم المجال العكسي؛ على سبيل المثال: com.microsoft.example.

3. تطالبك Maven بإدخال اسم artifactId لتطبيقك، والذي يجب أن يكون مرجعاً فريداً لمشروعك، على سبيل المثال: myapp.

4. قد تطالبك Maven بمعلمات أخرى، ويُمكنك قبول القيم الافتراضية بالضغط على مفتاح "Return/Enter" على جهاز الكمبيوتر الخاص بك. لا يلزمنا إلا groupId وartifactId في الوقت الحالي.

5. ينشئ Maven مشروع Azure Function محلي. mvn archetype:generate بمجرد اكتمال الأمر، يكون لديك مشروع Java بسيط جاهز لتخصيصه وبنائه.

في التمرين التالي، يمكنك استخدام هذه المعرفة لإنشاء وظيفة Azure باستخدام Maven.

متابعة