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

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

يمكنك استخدام السياسات المضمّنة في 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.

ويشمل ذلك بشكل عام كتابة رمز برمجي بلغة من هذه اللغات، ثم استدعاء الرمز من سياسة خاصة باللغة. لمزيد من المعلومات عن هذا الموضوع، اطّلِع على مقالة دمج رمز برمجي procedural.