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

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

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

نمط عميل HTTP في JavaScript

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

نمط إنشاء السياسات

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

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

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

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

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

راجِع استخدام تركيبة السياسات للحصول على مثال كامل يوضّح نمط تركيبة السياسات.