دمج القواعد الإجرائية

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

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

باستخدام الرمز الإجرائي، يمكنك:

  • إنشاء قيم معقّدة للنص الأساسي أو تعديلها، مثل قيم الطلبات والردود
  • إعادة كتابة عناوين URL، مثل إخفاء عنوان URL لنقطة نهاية مستهدَفة
  • إضافة منطق آخر غير متوفّر مع السياسات المضمّنة

آلية العمل

يمكنك استخدام سياسة خاصة باللغة من أجل إجراء مكالمات من مسار خادم وكيل إلى الرمز البرمجي المضمّن. بالنسبة إلى كل لغة من اللغات المتوافقة، يتضمّن Apigee Edge سياسة منفصلة: سياسة JavaScript وسياسة Java Callout وسياسة Python Script.

في ما يلي وصف عام لإحدى طرق عمل هذه الميزة. يُرجى الاطّلاع على مراجع السياسات لمعرفة المزيد من التفاصيل.

  1. في ملف منفصل، اكتب الرمز الذي ستستخدمه.
  2. في الرمز البرمجي، ضَع نتيجة معالجة الرمز في متغيّر مسار Apigee Edge.

    ستستردّ قيمة المتغيّر في مكان آخر في خادم وكيل واجهة برمجة التطبيقات. لمزيد من المعلومات حول متغيرات التدفق، يُرجى الاطّلاع على إدارة حالة الخادم الوكيل باستخدام متغيرات التدفق.

  3. أضِف ملفك (أو ملف JAR) كملف موارد إلى خادم وكيل واجهة برمجة التطبيقات.

    لمزيد من المعلومات حول ملفات الموارد، يُرجى الاطّلاع على ملفات الموارد.

  4. أضِف السياسة المناسبة للغة التي تستخدمها.

    اضبط السياسة لإجراء طلب إلى الرمز البرمجي من المكان المطلوب في مسار خادم وكيل واجهة برمجة التطبيقات.

  5. استخدِم سياسة لاسترداد قيمة الرمز من متغيّر التدفق.

القيود

لا يسمح نموذج الأمان في Apigee Edge باستدعاءات النظام، مثل إدخال/إخراج الشبكة، وعمليات القراءة/الكتابة في نظام الملفات، ومعلومات المستخدم الحالي، وقائمة العمليات، واستخدام وحدة المعالجة المركزية/الذاكرة. على الرغم من أنّ بعض هذه المكالمات قد تكون فعّالة، إلا أنّها غير متوافقة وقد يتم إيقافها في أي وقت. لضمان التوافق مع الإصدارات المستقبلية، عليك تجنُّب إجراء مثل هذه المكالمات في الرمز البرمجي.

قد تكون هناك قيود أخرى لكل لغة متاحة، كما هو موضّح في مرجع السياسة الخاص باللغة.

اللغات المتاحة

JavaScript

يتضمّن دعم JavaScript نموذج كائن كامل للتعامل مع المتغيّرات والقيم الخاصة بخادم وكيل لواجهة برمجة التطبيقات. لمزيد من المعلومات، اطّلِع على نموذج عناصر JavaScript.

للحصول على معلومات وأمثلة حول مرجع السياسة، راجِع سياسة JavaScript وخوادم وكيل لواجهة برمجة التطبيقات الخاصة بالبرمجة باستخدام JavaScript. للحصول على رمز نموذجي، ابحث في قائمة الأمثلة عن تلك التي تتضمّن JavaScript.

جافا

استخدِم سياسة Java Callout لتقديم طلبات إلى رمز Java من مسار الخادم الوكيل. يتضمّن موضوع مرجع السياسة أمثلة.

قد تهمّك أيضًا المواضيع التالية:

للحصول على نموذج رمز، ابحث في قائمة النماذج عن تلك التي تتضمّن Java.

Python

استخدِم سياسة نص Python البرمجي لاستدعاء رمز Python البرمجي.

للحصول على رمز نموذجي، ابحث في قائمة النماذج عن تلك التي تتضمّن Python.