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

  • مقالة
  • قراءة خلال 3 دقائق

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

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

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

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

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

لتثبيت Azure Toolkit ل IntelliJ ثم قم بتسجيل الدخول، اتبع الخطوات التالية:

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

    Azure Toolkit for IntelliJ plugin in Marketplace.

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

    The IntelliJ Azure Sign In command.

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

    The Azure Sign In window with device login selected.

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

    The Select Subscriptions dialog box.

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

لاستخدام Azure Toolkit ل IntelliJ لإنشاء مشروع Azure Functions محلي، اتبع الخطوات التالية:

  1. افتح مربع حوار الترحيب الخاص ب IntelliJ IDEA، وحدد Project جديدة لفتح معالج مشروع جديد، ثم حدد وظائف Azure.

    Create function project.

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

    Create function project finish.

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

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

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

    Local run project.

    Local run project output.

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

    Local run function test result.

  3. يتم عرض السجل أيضا في IDEA الخاص بك. أوقف تطبيق الوظيفة بالنقر فوق الزر إيقاف .

    Local run function test log.

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

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

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

    Local debug function app button.

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

    Local debug function app break.

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

لنشر مشروعك إلى Azure، اتبع الخطوات التالية:

  1. انقر بزر الماوس الأيمن فوق مشروعك في مستكشف IntelliJ Project، ثم حدد Azure -> نشر إلى وظائف Azure.

    Deploy project to Azure.

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

    Create function app in Azure.

    Deploy function app to Azure log.

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

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

  1. انقر فوق تطبيق الوظيفة وسترى جميع تطبيقات الوظائف الخاصة بك مدرجة.

    View function apps in explorer.

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

    Show function app properties.

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

    Screenshot shows a browser with the U R L.

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

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

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

    Add functions to the project entry.

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

    Screenshot shows the Create Function Class dialog box.

    Add functions to the project output.

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

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

Screenshot shows Delete selected from a context menu.

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

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

ربط بيانات مخرجات قائمة انتظار Azure Storage