تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

المعلومات التي ستكتسبها في هذا الموضوع

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

ما هو الطلب والاستجابة المباشران في Apigee Edge
حالات استخدام بث الطلبات والاستجابة
كيفية تفعيل بث الطلبات والاستجابة

ما المقصود ببث الطلبات والاستجابة؟

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

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

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

ملاحظة: إذا كانت واجهة برمجة التطبيقات تطلب قدرًا كبيرًا من البيانات أو تعرضها، قد يظهر لك HTTP هذا. خطأ:

{"fault":"{\"detail\":{\"errorcode\":\"protocol.http.TooBigBody\"},\"faultstring\":\"Body buffer overflow\"}"}

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

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

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

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

بالنسبة إلى الحمولات التي يزيد حجمها عن 10 ميغابايت، تنصح Apigee باستخدام نمط عناوين URL الموقعة ضمن Apigee JavaCallout، وهو موضح من خلال وسيلة شرح Edge: مثال على "منشئ عنوان URL الموقَّع" على GitHub.

في عمليات نشر Edge for 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. كرر هذا مع جميع معالجات الرسائل.

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

كيفية تفعيل بث الطلبات والاستجابة

لتفعيل ميزة "بث الطلب"، يجب إضافة 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. راجِع استخدام نماذج الخوادم الوكيلة لواجهة برمجة التطبيقات للحصول على معلومات عن تنزيل العينات واستخدامها.

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

البث - يوضح خادمًا وكيلاً لواجهة برمجة تطبيقات تم إعداده لبث HTTP.
وسيلة شرح Edge: أداة إنشاء عناوين URL الموقَّعة: توضح أفضل الممارسات لإنشاء عنوان URL موقَّع عنوان URL للوصول إلى الملفات الكبيرة بدلاً من محاولة الوصول المباشر إليها في طلب أو استجابة.