আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য
আপনার API প্রক্সির মাধ্যমে প্রবাহিত মেসেজ ম্যানিপুলেট করতে, Apigee Edge-এর সাথে অন্তর্ভুক্ত নীতিগুলি ব্যবহার করতে পারবেন। নীতির সাহায্যে আপনি এগুলি করতে পারবেন:
- XML থেকে JSON-এর মতো ফর্ম্যাটের মধ্যে মেসেজ কনভার্ট করা।
- মেসেজ কন্টেন্ট থেকে ভেরিয়েবল ভ্যালু সেট করা এবং ভেরিয়েবল ভ্যালু থেকে মেসেজ তৈরি করা।
- আরও জটিল উপায়ে মেসেজ ও ডেটা ম্যানেজ করতে JavaScript, Java ও Python-এর মতো প্রসিডিওরাল কোড ব্যবহার করুন।
সাধারণত, এইসব নীতি ব্যবহার করার সময়, আপনি ফ্লো ভেরিয়েবল হিসেবে ইনপুট ও আউটপুট নির্দিষ্ট করেন। রান টাইমে, Apigee Edge সোর্স ভেরিয়েবল থেকে ইনপুট ভ্যালু রিট্রিভ করে এবং আউটপুট ভেরিয়েবলে আউটপুট ভ্যালু লেখে।
এই বিষয় এইসব ক্ষমতা সম্পর্কে জানায়। আরও সম্পূর্ণ ও প্রযুক্তিগত তথ্যের জন্য, প্রতিটি বিষয়ের নীতি সংক্রান্ত রেফারেন্স দেখুন।
XML ও JSON সহজে ম্যানেজ করা যায়
Apigee Edge-এ এমন নীতি অন্তর্ভুক্ত থাকে যা XML ও JSON-এর মধ্যে কনভার্ট করা এবং XSL-এর মাধ্যমে XML ট্রান্সফর্ম করা সহজ করে তোলে।
JSON থেকে XML-এ কনভার্ট করা
JSON থেকে XML নীতি আপনার JSON ইনপুট নেয় এবং সেটি XML-এ কনভার্ট করে।
নিম্নলিখিত নীতির উদাহরণে, নীতিটি
request ভেরিয়েবল থেকে JSON-ফর্ম্যাট করা মেসেজ নেয়, তারপর ভেরিয়েবলের মান 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>
XSL-এর মাধ্যমে XML ট্রান্সফর্ম করা
XSL ব্যবহার করে মেসেজ ট্রান্সফর্ম করতে, আপনি XSL ট্রান্সফর্ম নীতি ব্যবহার করতে পারবেন। যেমন, JSON পে-লোডকে XML-এ কনভার্ট করার পরে, আপনার প্রয়োজনীয় ট্রান্সফর্মেশন পারফর্ম করতে, আপনি স্টাইল শিটের সাথে XSL ট্রান্সফর্ম নীতি ব্যবহার করতে পারবেন।
নিম্নলিখিত নীতির উদাহরণে, নীতিটি
response ভেরিয়েবেল থেকে XML-ফর্ম্যাট করা মেসেজ নেয়, তারপর
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-এর মতো পদ্ধতিগত ভাষা ব্যবহার করতে পারেন।
সাধারণত, এর মধ্যে এইসব ভাষার কোনও একটিতে কোড লেখা এবং তারপরে ভাষার জন্য নির্দিষ্ট নীতি থেকে কোডটি প্রয়োগ করা অন্তর্ভুক্ত। এই বিষয়ে আরও জানতে, প্রোসিডিওরাল কোড অন্তর্ভুক্ত করা দেখুন।