নীতি রচনা ব্যবহার করে

<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>

এই নীতিমালার উপাদানগুলোর একটি সংক্ষিপ্ত বিবরণ এখানে দেওয়া হলো। আপনি ‘বার্তা নির্ধারণ নীতি’ (Assign Message policy) -তে এই নীতিমালা সম্পর্কে আরও বিস্তারিত পড়তে পারেন।

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

ServiceCallout দিয়ে অনুরোধটি পাঠান

পলিসি তৈরির ক্রমের পরবর্তী ধাপ হলো একটি ServiceCallout পলিসি তৈরি করা। নিচে তালিকাভুক্ত ServiceCallout পলিসিটি, পূর্ববর্তী 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> - আগের পলিসির মতোই, এটিরও একটি নাম আছে।
• <অনুরোধ ভেরিয়েবল> - এটি সেই ভেরিয়েবল যা 'AssignMessage' পলিসিতে তৈরি করা হয়েছিল। এটি ব্যাকএন্ড এপিআই-তে পাঠানো অনুরোধটিকে ধারণ করে।
• <Response> - এই এলিমেন্টটি একটি ভেরিয়েবলের নাম দেয়, যেখানে রেসপন্সটি সংরক্ষিত থাকে। যেমনটি আপনি দেখতে পাবেন, এই ভেরিয়েবলটি পরবর্তীতে ExtractVariables পলিসি দ্বারা অ্যাক্সেস করা হবে।
• <HTTPTargetConnection> - ব্যাকএন্ড এপিআই-এর টার্গেট ইউআরএল নির্দিষ্ট করে। এক্ষেত্রে, আমরা নির্দিষ্ট করে দিই যে এপিআই একটি JSON রেসপন্স ফেরত দেবে।

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

<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> - এই এলিমেন্টটি আমাদের প্রয়োজনীয় রেসপন্স ডেটা সংগ্রহ করে এবং সেগুলোকে নামযুক্ত ভেরিয়েবলে রাখে। প্রকৃতপক্ষে, জিওকোডিং এপিআই অক্ষাংশ এবং দ্রাঘিমাংশের চেয়েও অনেক বেশি তথ্য ফেরত দেয়। তবে, এই স্যাম্পলটির জন্য আমাদের শুধু এই মানগুলোই প্রয়োজন। জিওকোডিং এপিআই দ্বারা ফেরত আসা JSON-এর একটি সম্পূর্ণ রেন্ডারিং আপনি এপিআই-এর ডকুমেন্টেশনে দেখতে পারেন। geometry.location.lat এবং geometry.location.lng-এর মানগুলো হলো ফেরত আসা JSON অবজেক্টের অনেকগুলো ফিল্ডের মধ্যে মাত্র দুটি।

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

• ভূ-কোড প্রতিক্রিয়া.অক্ষাংশ
• ভূ-কোড প্রতিক্রিয়া.দ্রাঘিমাংশ

বেশিরভাগ কাজ এখন সম্পন্ন হয়েছে। আমরা তিনটি পলিসির একটি সংমিশ্রণ তৈরি করেছি যা একটি অনুরোধ গঠন করে, একটি ব্যাকএন্ড এপিআই কল করে এবং ফেরত আসা JSON ডেটা পার্স করে। চূড়ান্ত ধাপে, আমরা ফ্লো-এর এই অংশ থেকে ডেটা অন্য একটি AssignMessage পলিসিতে ফিড করব, দ্বিতীয় ব্যাকএন্ড এপিআই (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 (locations) এবং এর মান হলো অক্ষাংশ ও দ্রাঘিমাংশ (কমা দ্বারা পৃথক করা মান)। অন্য প্যারামিটারটি হলো sensor ), যা আবশ্যক এবং এর মান অবশ্যই ট্রু (true) বা ফলস (false) হতে হবে। এই মুহূর্তে সবচেয়ে গুরুত্বপূর্ণ বিষয় হলো, আমরা এখানে যে রিকোয়েস্ট মেসেজটি তৈরি করি তার জন্য কোনো সার্ভিসকলআউট (ServiceCallout) প্রয়োজন হয় না। এই পর্যায়ে আমাদের দ্বিতীয় এপিআই-টিকে সার্ভিসকলআউট থেকে কল করার প্রয়োজন নেই, কারণ আমরা প্রক্সির টার্গেটএন্ডপয়েন্ট (TargetEndpoint) থেকে ব্যাকএন্ড এপিআই-টিকে কল করতে পারি। ভেবে দেখলে, গুগল এলিভেশন এপিআই কল করার জন্য আমাদের প্রয়োজনীয় সমস্ত ডেটা রয়েছে। এই ধাপে তৈরি করা রিকোয়েস্ট মেসেজটির জন্য সার্ভিসকলআউটের প্রয়োজন হয় না, কারণ এটি মূল রিকোয়েস্ট পাইপলাইনের জন্য তৈরি করা হয়েছে, এবং তাই এটি এই এপিআই প্রক্সির জন্য কনফিগার করা রাউটরুল (RouteRule) অনুসরণ করে প্রক্সিএন্ডপয়েন্ট (ProxyEndpoint) দ্বারা টার্গেটএন্ডপয়েন্টে (TargetEndpoint) ফরোয়ার্ড করা হবে। টার্গেটএন্ডপয়েন্ট রিমোট এপিআই-এর সাথে সংযোগটি পরিচালনা করে। মনে রাখবেন যে, এলিভেশন এপিআই-এর জন্য ইউআরএলটি টার্গেটএন্ডপয়েন্টের এইচটিটিপিকানেকশনে সংজ্ঞায়িত করা থাকে। আরও জানতে চাইলে এলিভেশন এপিআই ডকুমেন্টেশন দেখতে পারেন। আমরা পূর্বে যে কোয়েরিপ্যারামসগুলো সংরক্ষণ করেছিলাম, country এবং postalcode , সেগুলোর আর প্রয়োজন নেই, তাই আমরা এখান থেকে সেগুলো সরিয়ে দিচ্ছি।

সংক্ষিপ্ত বিরতি: আবার স্বাভাবিক ছন্দে ফেরা।

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

আপনি যদি নমুনা এপিআই প্রক্সিটি ডাউনলোড করে থাকেন, তাহলে আপনি TargetProxy XML-টি doc-samples/policy-mashup-cookbook/apiproxy/targets/default.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>

এখন, আমাদের শুধু গুগল এলিভেশন এপিআই থেকে পাওয়া প্রতিক্রিয়াটি প্রক্রিয়া করতে হবে এবং আমাদের কাজ শেষ।

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

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

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

সারসংক্ষেপ

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