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

أنت تطّلع على مستندات 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

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

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

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

Python

استخدِم سياسة نص Python البرمجيللإشارة إلى رمز Python.

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