أنماط الخادم الوكيل لواجهة برمجة التطبيقات

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

يناقش هذا الموضوع بعض أنماط تطوير الخادم الوكيل لواجهة برمجة التطبيقات الموضحة في نماذج كتاب طبخ Apigee Edge. ومع إضافة المزيد من نماذج كتب الطبخ، نخطط لإضافة المزيد من الأنماط إلى هذا الموضوع.

نمط عميل HTTP في JavaScript

نمط عميل HTTP الذي يتضمّن JavaScript هو نمط من بين العديد من الأنماط التي يمكنك استخدامها لإنشاء عمليات مزج من جهة الخادم باستخدام Apigee Edge. يتيح لك نموذج كائن JavaScript في Apigee توصيل رمز JavaScript مباشرةً في مسار الخادم الوكيل لواجهة برمجة التطبيقات. يسمح لك الكائن httpClient التابع لنموذج الكائن بإجراء استدعاءات لخدمات الخلفية واسترداد النتائج باستخدام JavaScript.

نمط تكوين السياسة

إنّ إنشاء السياسة هو نمط خادم وكيل Apigee API يتيح لك دمج النتائج من استهدافات خلفية متعددة في استجابة واحدة باستخدام السياسات. في الواقع، يتيح لك تكوين السياسات إنشاء تطبيقات مركبة باستخدام السياسات.

تعتمد سياسة ServiceCallout على نمط تكوين السياسة. تعمل سياسة ServiceCallout كعميل HTTP لواجهة برمجة التطبيقات أو الخدمة الخلفية. ومع ذلك، لكي تعمل ServiceCallout بشكل كامل، تعتمد على سياسات أخرى لتفعيل التفاعل الهادف مع واجهة برمجة تطبيقات أو خدمة عن بُعد. ويتم استخدام سياسات أخرى لإنشاء رسالة الطلب التي يتم إرسالها من خلال ServiceCallout ولتحليل محتوى رسالة الرد من واجهة برمجة التطبيقات أو الخدمة البعيدة.

يستخدم مثال على كتاب الطبخ الخاص بالسياسة ثلاث سياسات: AssignMessage وServiceCallout وExtractVariables. وتتضمّن هذه السياسات رسائل الطلبات التي تريد إرسالها إلى الخلفية والعميل الذي يوجِّه الرسالة إلى الخلفية ومحلّل الرسائل الذي يحلّل الرد من كل واجهة برمجة تطبيقات ويحدّد متغيّرات لبيانات الرد. بعد إجراء جميع الطلبات، يتم دمج المتغيّرات التي تم جمعها وعرضها في عنصر JSON واحد.

في ما يلي ملخّص سريع عن هذه السياسات الثلاث:

  • AssignMessage: تنشئ رسالة طلب وتملأ عناوين HTTP ومَعلمات طلب البحث وتضبط فعل HTTP.
  • ServiceCallout: تشير إلى رسالة تم إنشاؤها من خلال السياسة AssignMessage، وتحدّد عنوان URL مستهدَفًا للمكالمة الخارجية، وتحدّد اسمًا لكائن الاستجابة الذي تعرضه الخدمة المستهدفة.
  • ExtractVariables: تحدّد عادةً تعبير JSONPath أو XPath الذي يحلّل الرسالة التي تم إنشاؤها بواسطة سياسة ServiceCallout السابقة. بعد ذلك، تضبط السياسة المتغيّرات التي تتضمّن القيم التي تم تحليلها من استجابة ServiceCallout.

للاطّلاع على مثال كامل يوضّح نمط تكوين السياسة، يمكنك الاطّلاع على مقالة استخدام صياغة السياسات.