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

أنت تعرض مستندات 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.

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