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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

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

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

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

آلية العمل

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

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

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

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

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

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

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

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

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

القيود

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

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

اللغات المعتمدة

JavaScript

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

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

Java

يمكنك استخدام سياسة وسائل شرح Java لإجراء استدعاءات لرمز Java من مسار الخادم الوكيل. ويشمل الموضوع المرجعي للسياسة أمثلة.

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

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

Python

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

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