إنشاء وظيفة Java الخاصة بك في Azure باستخدام IntelliJ

توضح هذه المقالة طريقة استخدام Java وIntelliJ لإنشاء وظيفة Azure.

على وجه التحديد، توضح هذه المقالة ما يلي:

• كيفية إنشاء وظيفة Java التي تم تشغيلها بواسطة HTTP في مشروع IntelliJ IDEA.
• خطوات اختبار وتصحيح أخطاء المشروع في بيئة التطوير المتكامل (IDE) على الكمبيوتر الخاص بك.
• إرشادات لتوزيع مشروع الوظيفة إلى وظائف Azure.

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

• حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
• تدعم Azure Java Development Kit (JDK)، الإصدار 8 أو 11 أو 17 أو 21. (Java 21 مدعوم حاليا فقط في المعاينة على Linux فقط)
• تم تثبيت IntelliJ IDEA Ultimate Edition أو Community Edition
• Maven 3.5.0+
• أحدث Function Core Tools

تركيب المكون الإضافي وتسجيل الدخول

لتركيب مجموعة أدوات Azure ل IntelliJ ثم تسجيل الدخول، اتبع الخطوات التالية:

1. في مربع حوار الإعدادات/تفضيلات IntelliJ IDEA (Ctrl+Alt+S)، حدد Plugins. ثم ابحث عن مجموعة أدوات Azure ل IntelliJ في Marketplace وحدد Install. بعد تثبيته، حدد Restart لتنشيط المكون الإضافي.

   

2. لتسجيل الدخول إلى حساب Azure الخاص بك، افتح الشريط الجانبي Azure Explorer ، ثم حدد أيقونة تسجيل الدخول إلى Azure في الشريط في الأعلى (أو من قائمة IDEA، حدد Tools > Azure Azure > Sign in).

   

3. في نافذة تسجيل الدخول إلى Azure، حدد OAuth 2.0، ثم حدد تسجيل الدخول. للحصول على خيارات تسجيل الدخول الأخرى، يرجى مراجعةإرشادات تسجيل الدخول لمجموعة أدوات Azure ل IntelliJ.

   

4. في المستعرض، قم بتسجيل الدخول باستخدام حسابك ثم عد إلى IntelliJ. في مربع الحوار تحديد الاشتراكات ، حدد الاشتراكات التي تريد استخدامها، ثم حدد تحديد.

   

إنشاء مشروعك المحلي

لاستخدام مجموعة أدوات Azure لـ IntelliJ لإنشاء مشروع وظائف Azure المحلي، اتبع هذه الخطوات:

1. افتح مربع حوار Welcome IntelliJ IDEA's، حدد New Project لفتح معالج مشروع جديد، حددAzure Functions.

   

2. حدد مشغل Http، ثم حدد التالي واتبع المعالج للانتقال إلى جميع التكوينات في الصفحات التالية. قم بتأكيد موقع المشروع، ثم حدد إنهاء. ثم يفتح Intellj IDEA مشروعك الجديد.

   

قم بتشغيل المشروع محلياً

لتشغيل المشروع محليًا، اتبع الخطوات الآتية:

هام

يجب أن يكون تكون متغيرات البيئة JAVA_HOME معينة بشكل صحيح على الدليل JDK المستخدم أثناء تجميع التعليمات البرمجية باستخدام Maven. تأكد من أن إصدار JDK على الأقل على نفس مستوى إعداد Java.version.

1. انتقل إلى src/main/java/org/example/functions/HttpTriggerJava.java لمشاهدة التعليمات البرمجية التي تم إنشاؤها. بجانب السطر 17، يجب أن تشاهد زر تشغيل أخضر. حدده ثم حدد تشغيل 'Functions-azur...'. يجب أن تشاهد تطبيق الوظائف الخاص بك يعمل محليا مع بعض السجلات.

   

   

2. يمكن تجربة الوظيفة عن طريق الوصول إلى نقطة النهاية المطبوعة من المستعرض، مثل http://localhost:7071/api/HttpTriggerJava?name=Azure.

   

3. يُعرض السجل أيضًا في IDEA الخاص بك. أوقف تطبيق الوظائف عن طريق تحديد إيقاف.

   

قم بتتبع أخطاء المشروع محلياً

لتتبع أخطاء المشروع محليًا، اتبع الخطوات الآتية:

1. حدد زرDebug في شريط الأدوات. إذا لم تشاهد شريط الأدوات، قم بتمكينه عن طريق اختيار عرض>شريط أدوات >المظهر.

   

2. حدد السطر 20 من الملف src/main/java/org/example/functions/HttpTriggerJava.java لإضافة نقطة توقف. قم بالوصول إلى نقطة http://localhost:7071/api/HttpTriggerJava?name=Azure النهاية مرة أخرى ويجب أن تجد أن نقطة التوقف قد تم الوصول إليها. يمكن بعد ذلك تجربة المزيد من ميزات تتبع الأخطاء مثل Step و Watch و Evaluation. أوقف جلسة تصحيح الأخطاء عن طريق تحديد إيقاف.

   

إنشاء تطبيق الوظائف في Azure

استخدم الخطوات التالية لإنشاء تطبيق دالة والموارد ذات الصلة في اشتراك Azure الخاص بك:

1. في Azure Explorer في IDEA، انقر بزر الماوس الأيمن فوق Function App ثم حدد Create.

2. حدد المزيد من الإعدادات وقدم المعلومات التالية في المطالبات:

   المطالبة	التحديد
   الاشتراك	حدد الاشتراك المطلوب استخدامه.
   مجموعة الموارد	اختر مجموعة الموارد لتطبيق الوظائف.
   الاسم	حدد اسم تطبيق وظائف جديد. يمكن قبول القيم الافتراضية.
   النظام الأساسي	حدد Windows-Java 17 أو نظام أساسي آخر حسب الاقتضاء.
   المنطقة	للحصول على أداء أفضل، اختر منطقة قريبة منك.
   خيارات الاستضافة	اختر خيارات الاستضافة لتطبيق الوظائف.
   تخطيط	اختر مستوى تسعير خطة App Service الذي تريد استخدامه، أو حدد + لإنشاء خطة App Service جديدة.

   هام

   لإنشاء تطبيقك في خطة Flex Consumption، حدد Flex Consumption. خطة Flex Consumption قيد المعاينة حاليا.

3. حدد موافق. يتم عرض إعلام بعد إنشاء تطبيق الوظائف.

توزيع مشروعك إلى Azure

لتوزيع مشروعك في Azure، اتبع الخطوات التالية:

1. حدد أيقونة Azure وقم بتوسيعها في مستكشف IntelliJ Project، ثم حدد Deploy to Azure -> Deploy to Azure Functions.

   

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

   

   

إدارة تطبيقات الوظائف من IDEA

لإدارة تطبيقات الوظائف باستخدام Azure Explorer في IDEA، اتبع الخطوات الآتية:

1. حدد Function App لمشاهدة جميع تطبيقات الوظائف الخاصة بك مدرجة.

   

2. حدد أحد تطبيقات الوظائف، ثم انقر بزر الماوس الأيمن وحدد إظهار الخصائص لفتح صفحة التفاصيل.

   

3. انقر بزر الماوس الأيمن فوق تطبيق وظيفة HttpTrigger-Java ، ثم حدد وظيفة المشغل في المستعرض. يجب أن ترى أن المستعرض مفتوح باستخدام عنوان URL للمشغل.

   

إضافة المزيد من الوظائف إلى المشروع

لإضافة المزيد من الوظائف إلى مشروعك، اتبع الخطوات التالية:

1. انقر بزر الماوس الأيمن فوق الحزمة org.example.functions وحدد New -> Azure Function Class.

   

2. املأ اسم الفئة HttpTest وحدد HttpTrigger في معالج إنشاء فئة الدالة، ثم حدد موافق لإنشاء. بهذه الطريقة، يمكن إنشاء وظائف جديدة كما تريد.

   

   

تنظيف الوظائف

حدد أحد تطبيقات الوظائف مستخدمًاAzure Explorer في IDEA، ثم انقر بزر الماوس الأيمن وحدد Delete. قد يستغرق تشغيل هذا الأمر عدة دقائق. عند الانتهاء، يتم تحديث الحالة في Azure Explorer.

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

لقد قمت بإنشاء مشروع Java باستخدام وظيفة تشغيل HTTP وتشغيله على الجهاز المحلي الخاص بك وتوزيعه في Azure. الآن، قم بتوسيع الوظيفة الخاصة بك عن طريق المتابعة إلى المقالة التالية:

إضافة ربط إخراج قائمة انتظار Azure Storage