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

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

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

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

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

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

XML और JSON को आसानी से मैनेज करना

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

JSON को XML में बदलना

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

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

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

XML को JSON में बदलना

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

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

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

XSL की मदद से एक्सएमएल में बदलाव करना

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

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

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