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

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

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

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

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

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

XML और JSON के लिए आसानी से इस्तेमाल किया जा सकता है

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

JSON को एक्सएमएल में बदलना

JSON से XML में बदलने की नीति, आपके JSON इनपुट को लेकर उसे XML में बदल देती है.

नीति के इस उदाहरण में, नीति 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 के साथ एक्सएमएल को बदलना

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

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

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