استخدام Groovy في السكريبتات

محرك سكريبت Groovy

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

تدعم أنواع السكريبت التالية إصدار محرك Groovy:

سكريبتات الخوارزمية المساعدة

يمكن تكوين سكريبتات الخوارزمية المساعدة لاستخدام محرك Groovy إذا كان يحتوي على أنواع خطوات موجهة إلى Groovy فقط. يوفر النظام طبقة مستوى علوي تم إنشاؤها آليًا تحدد الواجهة البرمجية للتطبيق (API) لنقطة الخوارزمية المساعدة. داخليًا، يجب توافق رمز Groovy مع اصطلاحات النظام لأنواع خوارزمية تستند إلى Java، بما في ذلك تضمين طريقة "استدعاء" التي هي نقطة إدخال الخوارزمية المساعدة والتعريف الخاص بالمعلمات "البرمجية" باستخدام التعليقات التوضيحية.

سكريبتات مكتبة Groovy

توفر سكريبتات مكتبة Groovy إمكانية إنشاء مجموعات للبرامج المساعدة العامة في Groovy التي يمكن استدعاؤها من داخل السكريبتات الأخرى. يجب أن تتضمن السكريبتات من هذا النوع نوع خطوة واحد من واجهة مكتبة Groovyحيث تم إدراج الطرق المتاحة على نحو عام في المكتبة. يتم تحديد رمز الدعم لهذه الطرق في نوع واحد أو أكثر من أنواع خطوة عناصر Groovy داخل سكريبت المكتبة. يمكن ‏للطرق المحددة في المكتبة الموافقة على الوسيطات وإرجاع القيم من أي نوع. تقوم السكريبتات من هذا النوع باستخدام محرك Groovy وفقًا للإعدادات الافتراضية ولا يمكن تضمين أنواع خطوة كتابة السكريبت.

يمكن للسكريبتات التي يلزمها استدعاء الطرق من مكتبة Groovy استخدام طريقة createLibraryScript التي تم إدخالها بواسطة النظام لإنشاء مثيل واجهة المكتبة. تأكد من أن الفئة التي يتم إنشاء مثيل لها تتضمن امتداد اسم الملف .class.

استدعاء Groovy داخل محرك كتابة السكريبت

إذا تم تكوين سكريبت خوارزمية مساعدة أو سكريبت خدمة لاستخدام إصدار محرك كتابة سكريبت، يمكن أن يتضمن مزيج من نوعي الخطوة العادي وعناصر Groovy. ستحدد أنواع خطوة السكريبت العملية المطلوب تنفيذها. تحتوي خطوات عناصر Groovy على الرمز الذي يمكن استدعاؤه من أنواع، خطوة تحرير البيانات في السكريبت باستخدام أمر invokeGroovy. يتم دعم طرق Groovy فقط التي لا تقوم باستلام أية وسيطات وإلغاء إرجاع باستخدام هذا الأمر. لمزيد من التفاصيل، ارجع إلى القسم في خطوات تحرير البيانات.

فيما يخص السكريبتات التي تستخدم هذا الخيار، يوفر إطار العمل فئة مستوى علوي تحتوي على أساليب تدعم إجراءات كتابة السكريبت العامة مثل نقل الأوامر وتقييم السلسلة والطرق لاستدعاء كائنات العمل وخدمات العمل وسكريبتات الخدمة. للحصول على تفاصيل حول الطرق المدعومة، ارجع إلى مستندات Java المحددة للغة Groovy

عمليات استيراد فئات Groovy

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

التوافق مع الإصدارات السابقة

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

يوفر النظام برنامج مجموعة المعالجة F1-CAGVY الذي يقوم بالإبلاغ عن كل السكريبتات التي تتطلب خطوة الاستيراد الآلي لتجميعها بنجاح. بالإضافة إلى ذلك، يكون برنامج مجموعة المعالجة هذا مفيدًا عند ترقية إصدار Groovy لاكتشاف المشكلات المحتملة بشكل استباقي في تجميع السكريبتات الموجودة التي قد تحدث بسبب التغييرات في Groovy. يتم تشجيع النُسخ المعدلة على تشغيل برنامج مجموعة المعالجة هذا في المدى القصير لتحديد وإصلاح أية سكريبتات تفتقد إلى عمليات الاستيراد الواضحة وأيٍ من عمليات ترقية إصدار Groovy لمراجعة أية سكريبتات خاصة بالنسخة المعدلة يمكن الإبلاغ عنها.