طلبات البث والردود

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

المعلومات التي ستطّلع عليها في هذا الموضوع

بعد قراءة هذا الموضوع، ستعرف ما يلي:

  • ما هو بث الطلبات والاستجابة على Apigee Edge؟
  • حالات استخدام بث الطلبات والاستجابة
  • كيفية تفعيل بث الطلبات والردّ

ما هو المقصود ببث الطلبات والرد؟

بشكل تلقائي، يتمّ إيقاف بث HTTP وتتم كتابة حمولات طلبات HTTP وحمولات الاستجابة في مخازن مؤقتة في الذاكرة قبل معالجتها بواسطة مسار تعلّم الخادم الوكيل لواجهة برمجة التطبيقات. ويمكنك تغيير هذا السلوك من خلال تفعيل ميزة البث. عند تفعيل البث، يتم بث حمولات الطلبات والاستجابة بدون تعديل تطبيق العميل (للردود) ونقطة النهاية المستهدفة (للطلبات).

متى يجب تفعيل ميزة البث؟

إذا كان الخادم الوكيل لواجهة برمجة التطبيقات يتعامل مع طلبات و/أو استجابات كبيرة جدًا (لمعرفة الحدود القصوى للحجم، يُرجى مراجعة معلومات أخرى حول البث أدناه)، ننصحك بتفعيل البث.

معلومات أخرى يجب معرفتها عن البث

يقتصر حجم حمولة الرسالة على 10 ميغابايت في Edge Cloud و Private Cloud حتى في حال تفعيل البث. في الطلبات والردود التي لا يتم بثها، يؤدي تجاوز هذا الحجم إلى حدوث خطأ protocol.http.TooBigBody.

في Edge لعمليات نشر Private Cloud، يمكنك تعديل الحد الأقصى لحجم الطلبات/الاستجابة التي لا يتم بثها. واحرص على اختبار الميزة قبل تطبيق التغيير في مرحلة الإنتاج.

  • بالنسبة إلى إصدارات Edge for Private Cloud التي تسبق الإصدار 4.16.01:

    في جميع معالِجات الرسائل، عدِّل ملف http.properties لزيادة الحد الأقصى في المعلَمة HTTPResponse.body.buffer.limit ثم أعِد تشغيل معالج الرسائل.
  • بالنسبة إلى الإصدار 4.16.01 من Edge for Private Cloud والإصدارات الأحدث:
    1. عدِّل الملف /<inst_root>/apigee/customer/application/message-processor.properties. إذا لم يكن الملف موجودًا، فأنشئه.

    2. اضبط السمة conf_http_HTTPResponse.body.buffer.limit في message-processor.properties. على سبيل المثال:
      conf_http_HTTPResponse.body.buffer.limit=5m

    3. أعِد تشغيل معالج الرسائل:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-message-processor أعِد تشغيل

    4. كرِّر هذه الخطوة لجميع معالجات الرسائل.

كيفية تفعيل بث الطلبات والردّ

لتفعيل بث الطلبات، عليك إضافة السمة request.streaming.enabled إلى تعريفَي ProxyEndpoint وTargetEndpoint في حزمة الخادم الوكيل وضبطها على true. وبالمثل، يجب ضبط السمة response.streaming.enabled لتفعيل بث الردود.

يمكنك تحديد موقع ملفات الإعداد هذه في واجهة مستخدم الإدارة في عرض "التطوير" للخادم الوكيل. إذا كنت تطوِّر الإضافة محليًا، تتوفّر ملفات التعريفات هذه باللغتَين apiproxy/proxies وapiproxy/targets.

يعرض هذا النموذج كيفية تفعيل بث الطلبات والاستجابة في تعريف TargetEndpoint.

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
    <Properties>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
      <Property name="supports.http10">true</Property>
      <Property name="request.retain.headers">User-Agent,Referer,Accept-Language</Property>
      <Property name="retain.queryparams">apikey</Property>
    </Properties>
  </HTTPTargetConnection>
</TargetEndpoint>

يوضّح هذا المثال كيفية تفعيل بث الطلبات والاستجابة في تعريف ProxyEndpoint:

<ProxyEndpoint name="default">
  <HTTPProxyConnection>
    <BasePath>/v1/weather</BasePath>
    <Properties>
      <Property name="allow.http10">true</Property>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
    </Properties>
  </HTTPProxyConnection>
</ProxyEndpoint>

لمزيد من المعلومات حول ضبط تعريفات نقاط النهاية، يُرجى الاطّلاع على مرجع خصائص نقطة النهاية.

نماذج الرموز البرمجية ذات الصلة

من السهل تنزيل واستخدام نماذج وكيل واجهة برمجة التطبيقات على GitHub. يمكنك الاطّلاع على استخدام نماذج الخوادم الوكيلة لواجهة برمجة التطبيقات للحصول على معلومات حول تنزيل النماذج واستخدامها.

من بين نماذج الخوادم الوكيلة التي تتميز ببث المحتوى ما يلي: