নীতি কম্পোজিশন ব্যবহার করা

<AssignMessage name="GenerateGeocodingRequest">
  <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
  <Set>
    <QueryParams>
      <QueryParam name="address">{request.queryparam.postalcode}</QueryParam>
      <QueryParam name="region">{request.queryparam.country}</QueryParam>
      <QueryParam name="sensor">false</QueryParam>
    </QueryParams>
    <Verb>GET</Verb>
  </Set>
  <!-- Set variables for use in the final response -->
  <AssignVariable>
    <Name>PostalCode</Name>
    <Ref>request.queryparam.postalcode</Ref>
  </AssignVariable>
  <AssignVariable>
    <Name>Country</Name>
    <Ref>request.queryparam.country</Ref>
  </AssignVariable>
</AssignMessage>

এই নীতির এলিমেন্টগুলির সংক্ষিপ্ত বিবরণ এখানে দেওয়া হল। আপনি এই নীতি সম্পর্কে আরও জানতে অ্যাসাইন মেসেজ নীতি পড়ুন।

• <AssignMessage name> - এই নীতিকে একটি নাম দেয়। ফ্লোতে নীতি উল্লেখ করা হলে এই নাম ব্যবহার করা হয়।
• <AssignTo> - GeocodingRequest নামের একটি ভেরিয়েবল তৈরি করে। এই ভেরিয়েবলটি অনুরোধ অবজেক্টকে এনক্যাপসুলেট করে যা ServiceCallout নীতি দ্বারা ব্যাকএন্ডে পাঠানো হবে।
• <QueryParams> - ব্যাকএন্ড API কলের জন্য প্রয়োজনীয় কোয়েরি প্যারামিটার সেট করে। এই ক্ষেত্রে, জিওকোডিং API-কে লোকেশন জানতে হবে, যা পোস্টাল কোড ও কান্ট্রি আইডির মাধ্যমে প্রকাশ করা হয়। অ্যাপ ব্যবহারকারী এই তথ্য প্রদান করেন এবং আমরা এখান থেকে তা এক্সট্র্যাক্ট করি। API-এর জন্য sensor param প্রয়োজন এবং এটি true বা false হতে পারে এবং আমরা এখানে এটিকে false হিসেবে হার্ডকোড করেছি।
• <Verb> - এই ক্ষেত্রে, আমরা API-তে একটি সাধারণ GET অনুরোধ করছি।
• <AssignVariable> - এইসব ভেরিয়েবল, API-তে পাস করা ভ্যালু সেভ করে। এই উদাহরণে, ক্লায়েন্টকে ফেরত দেওয়া উত্তরে ভেরিয়েবল পরে অ্যাক্সেস করা হবে।

ServiceCallout সহ অনুরোধ পাঠান

নীতি কম্পোজিশন সিকোয়েন্সের পরবর্তী ধাপ হল ServiceCallout নীতি তৈরি করা। নিচে তালিকাভুক্ত ServiceCallout নীতি, Google Geocoding পরিষেবায় আগের AssignMessage নীতিতে তৈরি করা অনুরোধ অবজেক্ট পাঠায় এবং GeocodingResponse নামের ভেরিয়েবলে ফলাফল সেভ করে।

<ServiceCallout name="ExecuteGeocodingRequest">
  <Request variable="GeocodingRequest"/>
  <Response>GeocodingResponse</Response>
  <HTTPTargetConnection>
    <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
  </HTTPTargetConnection>
</ServiceCallout>

এই নীতির এলিমেন্টগুলির সংক্ষিপ্ত বিবরণ এখানে দেওয়া হল।

• <ServiceCallout> - আগের নীতির মতো, এটিরও একটি নাম আছে।
• <Request variable> - This is the variable that was created in the AssignMessage policy. এটি ব্যাকএন্ড API-তে যাওয়া অনুরোধকে এনক্যাপসুলেট করে।
• <Response> - এই এলিমেন্টটি এমন একটি ভেরিয়েবলের নাম দেয় যেখানে উত্তরটি স্টোর করা হয়। আপনি দেখতে পাবেন যে ExtractVariables নীতি পরে এই ভেরিয়েবল অ্যাক্সেস করবে।
• <HTTPTargetConnection> - Specifies the target URL of the backend API. এই ক্ষেত্রে, আমরা নির্দিষ্ট করি যে API একটি JSON উত্তর রিটার্ন করবে।

এখন আমাদের দুটি নীতি আছে, একটিতে ব্যাকএন্ড API (Google-এর জিওকোডিং API) ব্যবহার করার জন্য প্রয়োজনীয় অনুরোধ সংক্রান্ত তথ্য নির্দিষ্ট করা আছে এবং দ্বিতীয়টিতে ব্যাকএন্ড API-তে অনুরোধ পাঠানো হয়। এরপরে, আমরা উত্তর ম্যানেজ করব।

<ExtractVariables name="ParseGeocodingResponse">
  <Source>GeocodingResponse</Source>
  <VariablePrefix>geocoderesponse</VariablePrefix>
  <JSONPayload>
    <Variable name="latitude">
       <JSONPath>$.results[0].geometry.location.lat</JSONPath>
    </Variable>
    <Variable name="longitude">
       <JSONPath>$.results[0].geometry.location.lng</JSONPath>
    </Variable>
  </JSONPayload>
</ExtractVariables>

ExtractVariable নীতির মূল উপাদানগুলি হল:

• <ExtractVariables name> - আবার, কোনও ফ্লোতে ব্যবহার করা হলে, নীতিটি উল্লেখ করার জন্য নীতির নাম ব্যবহার করা হয়।
• <Source> - ServiceCallout নীতিতে আমরা যে রেসপন্স ভেরিয়েবল তৈরি করেছি সেটি নির্দিষ্ট করে । এই ভেরিয়েবল থেকে এই নীতি ডেটা এক্সট্র্যাক্ট করে।
• <VariablePrefix> - ভেরিয়েবল প্রিফিক্স এই নীতিতে তৈরি করা অন্যান্য ভেরিয়েবলের জন্য নেমস্পেস নির্দিষ্ট করে। প্রিফিক্স যেকোনও নাম হতে পারে, তবে Edge-এর আগে থেকে সংজ্ঞায়িত ভেরিয়েবল দ্বারা সংজ্ঞায়িত রিজার্ভ করা নামগুলি ব্যবহার করা যাবে না।
• <JSONPayload> - এই এলিমেন্টটি আমাদের আগ্রহের রেসপন্স ডেটা পুনরুদ্ধার করে এবং এটিকে নামযুক্ত ভেরিয়েবলে রাখে। আসলে, Geocoding API, অক্ষাংশ ও দ্রাঘিমাংশের থেকে অনেক বেশি তথ্য প্রদান করে। তবে, এই স্যাম্পেলের জন্য আমাদের শুধু এই মানগুলিই প্রয়োজন। আপনি API-এর ডকুমেন্টেশনে Geocoding API-এর মাধ্যমে রিটার্ন করা JSON-এর সম্পূর্ণ রেন্ডারিং দেখতে পাবেন। geometry.location.lat এবং geometry.location.lng-এর ভ্যালু হল ফেরানো JSON অবজেক্টের অনেক ফিল্ডের মধ্যে দুটি।

এটি হয়ত স্পষ্ট নয়, কিন্তু এটি দেখা গুরুত্বপূর্ণ যে ExtractVariables দুটি ভেরিয়েবল তৈরি করে, যার নামে ভেরিয়েবল প্রিফিক্স (geocoderesponse) এবং প্রকৃত ভেরিয়েবলের নাম থাকে যা নীতিতে উল্লেখ করা হয়েছে। এইসব ভেরিয়েবল API প্রক্সিতে স্টোর করা হয় এবং প্রক্সি ফ্লোয়ের মধ্যে অন্যান্য নীতির জন্য উপলভ্য থাকে, যেমন আপনি দেখতে পাবেন। ভেরিয়েবলগুলি হল:

• geocoderesponse.latitude
• geocoderesponse.longitude

বেশিরভাগ কাজ এখন হয়ে গেছে। আমরা তিনটি নীতির একটি কম্পোজিট তৈরি করেছি যা একটি অনুরোধ তৈরি করে, একটি ব্যাকএন্ড API কল করে এবং ফিরে আসা JSON ডেটা পার্স করে। শেষ ধাপে, আমরা ফ্লোয়ের এই অংশ থেকে পাওয়া ডেটা অন্য একটি AssignMessage নীতিতে ফিড করব, দ্বিতীয় ব্যাকএন্ড API (Google Elevation API) কল করব এবং অ্যাপ ডেভেলপারকে আমাদের ম্যাস-আপ করা ডেটা ফেরত দেব।

<AssignMessage name="AssignElevationParameters">
<Remove>
    <QueryParams>
      <QueryParam name="country"/>
      <QueryParam name="postalcode"/>
    </QueryParams>
  </Remove>
  <Set>
    <QueryParams>
      <QueryParam name="locations">{geocoderesponse.latitude},{geocoderesponse.longitude}</QueryParam>
      <QueryParam name="sensor">false</QueryParam>
    </QueryParams>
  </Set>
</AssignMessage>

আপনি Google Elevation API পরীক্ষা করে দেখলে, দেখতে পাবেন যে এটি দুটি কোয়েরি প্যারামিটার নেয়। প্রথমটি হল locations এবং এর মান হল অক্ষাংশ ও দ্রাঘিমাংশ (কমা দিয়ে আলাদা করা মান)। অন্য প্যারামিটারটি হল sensor, যেটি প্রয়োজন এবং অবশ্যই true বা false হতে হবে। এই পর্যায়ে সবচেয়ে গুরুত্বপূর্ণ বিষয় হল, আমরা এখানে যে অনুরোধ মেসেজ তৈরি করি তার জন্য ServiceCallout-এর প্রয়োজন হয় না। এই মুহূর্তে ServiceCallout থেকে দ্বিতীয় API কল করার প্রয়োজন নেই কারণ আমরা প্রক্সির TargetEndpoint থেকে ব্যাকএন্ড API কল করতে পারি। আপনি যদি এটি সম্পর্কে চিন্তা করেন, তাহলে Google Elevations API কল করার জন্য আমাদের কাছে প্রয়োজনীয় সমস্ত ডেটা আছে। এই ধাপে তৈরি হওয়া অনুরোধ মেসেজে ServiceCallout-এর প্রয়োজন নেই, কারণ মূল অনুরোধ পাইপলাইনের জন্য অনুরোধ তৈরি করা হয়েছে এবং তাই এই API প্রক্সির জন্য কনফিগার করা RouteRule অনুসরণ করে ProxyEndpoint থেকে TargetEndpoint-এ ফরোয়ার্ড করা হবে। TargetEndpoint রিমোট API-এর সাথে কানেকশন ম্যানেজ করে। (মনে রাখবেন যে TargetEndpoint-এর জন্য HTTPConnection-এ এলিভেশন API-এর URL সংজ্ঞায়িত করা হয়েছে। আপনি আরও জানতে চাইলে Elevation API ডকুমেন্টেশন দেখুন। আগে সেভ করা QueryParams, country এবং postalcode-এর আর প্রয়োজন নেই, তাই আমরা সেগুলি এখান থেকে সরিয়ে দিচ্ছি।

সংক্ষিপ্ত বিরতি: ফ্লোতে ফিরে যাওয়া

এই পর্যায়ে, আপনি ভাবতে পারেন যে আমরা কেন আরেকটি ServiceCallout নীতি তৈরি করছি না। সব মিলিয়ে আমরা আরেকটি মেসেজ তৈরি করেছি। সেই মেসেজটি কীভাবে টার্গেট, Google Elevation API-তে পাঠানো হয়? ফ্লোয়ের <RouteRule> এলিমেন্টে উত্তরটি রয়েছে। <RouteRule> ফ্লোয়ের <Request> অংশটি এক্সিকিউট করার পরে বাকি থাকা অনুরোধ মেসেজ নিয়ে কী করতে হবে তা নির্দিষ্ট করে। এই <RouteRule>-এর মাধ্যমে নির্দিষ্ট করা TargetEndpoint, API প্রক্সিটিকে মেসেজটি http://maps.googleapis.com/maps/api/elevation/xml-এ ডেলিভার করার কথা বলে।

আপনি যদি স্যাম্পেল API প্রক্সি ডাউনলোড করে থাকেন, তাহলে আপনি ফাইল doc-samples/policy-mashup-cookbook/apiproxy/targets/default.xml-এ TargetProxy XML খুঁজে পাবেন।

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://maps.googleapis.com/maps/api/elevation/xml</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

এখন, আমাদের শুধু Google Elevation API থেকে পাওয়া উত্তর প্রসেস করতে হবে এবং আমাদের কাজ শেষ।

$ curl "http://{myorg}-test.apigee.net/policy-mashup-cookbook?country=us&postalcode=08008"

উত্তরে অ্যাপের শেষ ব্যবহারকারীর দেওয়া পোস্টাল কোডের কেন্দ্রস্থলের জিওকোড করা লোকেশন এবং সেই জিওকোড করা লোকেশনের উচ্চতা অন্তর্ভুক্ত থাকে। ডেটা দুটি ব্যাকএন্ড API থেকে নেওয়া হয়েছে, API প্রক্সির সাথে অ্যাটাচ করা নীতি অনুযায়ী তা মিক্স করা হয়েছে এবং একটি রেসপন্সের মাধ্যমে ক্লায়েন্টকে ফেরত দেওয়া হয়েছে।

{  
   "country":"us",
   "postalcode":"08008",
   "elevation":{  
      "meters":0.5045232,
      "feet":1.6552599030345978
   },
   "location":{  
      "latitude":39.75007129999999,
      "longitude":-74.1357407
   }
}

সারাংশ

এই কুকবুক টপিকে একাধিক ব্যাকএন্ড সোর্স থেকে পাওয়া ডেটা ম্যাশ-আপ করতে নীতি কম্পোজিশন প্যাটার্ন কীভাবে ব্যবহার করতে হয় তা ব্যাখ্যা করা হয়েছে। আপনার API-তে ক্রিয়েটিভ ফাংশনালিটি যোগ করার জন্য API প্রক্সি ডেভেলপমেন্টে নীতি কম্পোজিশন একটি সাধারণ প্যাটার্ন হিসেবে ব্যবহার করা হয়।