मैसेज को आकार देना, ऐक्सेस करना, और उन्हें फ़ॉर्मैट में बदलना

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी

एपीआई प्रॉक्सी से आने वाले मैसेज में हेर-फेर करने के लिए, Apigee Edge में शामिल नीतियों का इस्तेमाल किया जा सकता है. नीतियों की मदद से, ये काम किए जा सकते हैं:

• मैसेज को अलग-अलग फ़ॉर्मैट, जैसे कि एक्सएमएल से JSON में बदलें.
• मैसेज के कॉन्टेंट से वैरिएबल वैल्यू सेट करें और वैरिएबल वैल्यू से मैसेज बनाएं.
• मैसेज और डेटा को ज़्यादा मुश्किल तरीकों से मैनेज करने के लिए, JavaScript, Java, और Python जैसे प्रोसेसल कोड का इस्तेमाल करें.

आम तौर पर, इन नीतियों का इस्तेमाल करते समय, इनपुट और आउटपुट को फ़्लो वैरिएबल के तौर पर तय किया जाता है. रन टाइम के दौरान, Apigee Edge, सोर्स वैरिएबल से इनपुट वैल्यू हासिल करता है और आउटपुट वैल्यू को आउटपुट वैरिएबल में लिखता है.

इस विषय में इन सुविधाओं के बारे में बताया गया है. पूरी और तकनीकी जानकारी के लिए, हर एक नीति के रेफ़रंस देखें.

एक्सएमएल और JSON को आसान तरीके से हैंडल करना

Apigee Edge में ऐसी नीतियां शामिल हैं जिनकी मदद से, एक्सएमएल और JSON के बीच कन्वर्ज़न को आसान बनाया जा सकता है और एक्सएमएल को XSL के साथ बदला जा सकता है.

JSON को एक्सएमएल में बदला जा रहा है

JSON से एक्सएमएल में बनाई गई नीति, आपके JSON इनपुट को एक्सएमएल में बदलती है.

नीति के नीचे दिए गए उदाहरण में, यह नीति request वैरिएबल से JSON फ़ॉर्मैट वाला मैसेज लेती है. इसके बाद, वैरिएबल की वैल्यू को एक्सएमएल के फ़ॉर्मैट वाले मैसेज से बदल देती है. इनपुट की जानकारी <Source> एलिमेंट में दी गई है, जबकि आउटपुट की जानकारी <OutputVariable> एलिमेंट में दी गई है.

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

एक्सएमएल को JSON में बदला जा रहा है

एक्सएमएल से JSON नीति, एक्सएमएल इनपुट मैसेज को JSON में बदलती है.

नीति के नीचे दिए गए उदाहरण में, यह नीति response वैरिएबल से एक्सएमएल फ़ॉर्मैट वाला मैसेज लेती है. इसके बाद, वैरिएबल वैल्यू को JSON के फ़ॉर्मैट वाले मैसेज से बदल देती है. इनपुट की जानकारी <Source> एलिमेंट में दी गई है, जबकि आउटपुट की जानकारी <OutputVariable> एलिमेंट में दी गई है.

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

एक्सएमएल को XSL के साथ बदलना

XSL का इस्तेमाल करके मैसेज को बदलने के लिए, XSL बदलाव की नीति का इस्तेमाल किया जा सकता है. उदाहरण के लिए, JSON पेलोड को एक्सएमएल में बदलने के बाद, अपनी ज़रूरत के हिसाब से बदलाव करने के लिए, XSL Transform नीति का इस्तेमाल स्टाइल शीट के साथ किया जा सकता है.

इस नीति के उदाहरण में, यह नीति 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 जैसी प्रोसेस वाली भाषाओं का इस्तेमाल किया जा सकता है. इन भाषाओं की जटिलताएं, शामिल की गई नीतियों के दायरे से बाहर की हैं.

आम तौर पर, इसमें इनमें से किसी एक भाषा में कोड लिखना और फिर उस भाषा के लिए खास किसी नीति के तहत कोड को लागू करना शामिल होता है. इसके बारे में ज़्यादा जानने के लिए, प्रोसेसल कोड शामिल करना देखें.