تشكيل الرسائل والوصول إليها وتحويلها

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

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

• تحويل الرسائل بين التنسيقات، مثلاً من XML إلى JSON
• قم بتعيين قيم المتغير من محتوى الرسالة، وإنشاء رسائل من قيم المتغير.
• استخدِم رمزًا برمجيًا إجرائيًا، مثل JavaScript وJava وPython للتعامل مع الرسائل والبيانات بطرق أكثر تعقيدًا.

بوجه عام، عند استخدام هذه السياسات، يمكنك تحديد الإدخال والإخراج كمتغيّرات تدفق. في وقت التشغيل، تستردّ Apigee Edge قيمة الإدخال من متغيّر مصدر وتكتب قيمة الإخراج إلى متغيّر إخراج.

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

معالجة بسيطة لـ XML وJSON

يتضمّن Apigee Edge سياسات تسهّل التحويل بين XML وJSON، وتحويل تنسيق XML باستخدام XSL.

تحويل JSON إلى XML

تأخذ السياسة من تنسيق JSON إلى XML إدخال JSON وتحوّله إلى تنسيق XML.

في مثال السياسة التالي، تأخذ السياسة رسالة بتنسيق JSON من المتغيّر request، ثم تستبدل قيمة المتغيّر برسالة بتنسيق XML. يتم تحديد الإدخال في العنصر <Source>، بينما يتم تحديد المخرجات في العنصر <OutputVariable>.

<JSONToXML name="jsontoxml">
     <Source>request</Source>
     <OutputVariable>request</OutputVariable>
</JSONToXML>

تحويل XML إلى JSON

تحوّل سياسة XML إلى JSON رسالة إدخال XML إلى JSON.

في مثال السياسة التالي، تأخذ السياسة رسالة بتنسيق XML من المتغيّر response، ثم تستبدل قيمة المتغيّر برسالة بتنسيق JSON. يتم تحديد الإدخال في العنصر <Source>، بينما يتم تحديد المخرجات في العنصر <OutputVariable>.

<XMLToJSON name="ConvertToJSON">
   <OutputVariable>response</OutputVariable>
   <Source>response</Source>
</XMLToJSON>

تحويل XML باستخدام XSL

يمكنك استخدام سياسة التحويل لـ XSL لتحويل الرسائل باستخدام XSL. على سبيل المثال، بعد تحويل حمولة JSON إلى XML، يمكنك استخدام سياسة تحويل XSL مع ورقة أنماط لإجراء التحويل الذي تحتاج إليه.

في مثال السياسة التالي، تأخذ السياسة رسالة بتنسيق XML من المتغيّر response، ثم تستبدل قيمة المتغيّر برسالة تم تنسيقها من خلال my_transform.xsl. يتم تحديد الإدخال في العنصر <Source>، بينما يتم تحديد المخرجات في العنصر <OutputVariable>.

<XSL name="TransformXML">
    <ResourceURL>xsl://my_transform.xsl</ResourceURL>
    <Source>response</Source>
    <OutputVariable>response</OutputVariable>
</XSL>

    <Source>request</Source>
    <ResourceURL>xsl://XSL-Transform-1.xsl</ResourceURL>
    <OutputVariable/>

معالجة بيانات المتغيرات

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

احرص على الاطّلاع على مراجع للسياستَين التاليتَين:

• تحديد سياسة الرسالة لإنشاء رسائل من قيم المتغيّرات.
• استخراج سياسة المتغيّرات لتعيين المتغيرات من محتوى الرسالة.

إنشاء عمليات تحويل أكثر تعقيدًا

وبالنسبة إلى معالجة البيانات التي تتجاوز تعقيدها إمكانية تنفيذ السياسات المضمّنة، يمكنك استخدام لغات إجرائية مثل JavaScript أو Java أو Python.

وبشكل عام، يشمل ذلك كتابة الرموز البرمجية بإحدى هذه اللغات، ثم استدعاء الرمز استنادًا إلى سياسة خاصة باللغة. لمزيد من المعلومات حول هذا الموضوع، يُرجى مراجعة دمج الرموز الإجرائية.