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

<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-এর লোকেশন জানতে হবে, যা একটি পোস্টাল কোড এবং একটি দেশের আইডি দিয়ে প্রকাশ করা হয়। অ্যাপ ব্যবহারকারী এই তথ্য সরবরাহ করে, এবং আমরা কেবল এটি এখানে বের করি। sensor প্যারাম এপিআই দ্বারা প্রয়োজনীয়, এবং হয় সত্য বা মিথ্যা, এবং আমরা এখানে এটিকে মিথ্যাতে হার্ডকোড করি।
• <ক্রিয়া > - এই ক্ষেত্রে, আমরা API এ একটি সহজ GET অনুরোধ করছি।
• <অ্যাসাইন ভ্যারিয়েবল> - এই ভেরিয়েবলগুলি আমরা API-তে যে মানগুলি প্রেরণ করছি তা সংরক্ষণ করে। এই উদাহরণে, ভেরিয়েবলগুলি পরে ক্লায়েন্টের কাছে ফিরে আসা প্রতিক্রিয়াতে অ্যাক্সেস করা হবে।

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

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

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

এখানে এই নীতির উপাদানগুলির একটি সংক্ষিপ্ত বিবরণ রয়েছে৷

• <সার্ভিসকলআউট> - পূর্ববর্তী নীতির মতো, এটির একটি নাম রয়েছে।
• <রিকোয়েস্ট ভেরিয়েবল> - এটি সেই ভেরিয়েবল যা AssignMessage নীতিতে তৈরি করা হয়েছিল। এটি ব্যাকএন্ড এপিআই-এ যাওয়ার অনুরোধকে এনক্যাপসুলেট করে।
• <প্রতিক্রিয়া> - এই উপাদানটি একটি ভেরিয়েবলের নাম দেয় যেখানে প্রতিক্রিয়া সংরক্ষণ করা হয়। যেমন আপনি দেখতে পাবেন, এই ভেরিয়েবলটি পরে এক্সট্রাক্ট ভেরিয়েবল নীতি দ্বারা অ্যাক্সেস করা হবে।
• <HTTPTargetConnection> - ব্যাকএন্ড API এর টার্গেট URL নির্দিষ্ট করে। এই ক্ষেত্রে, আমরা নির্দিষ্ট করি যে API একটি JSON প্রতিক্রিয়া প্রদান করে।

এখন আমাদের কাছে দুটি নীতি রয়েছে, একটি যা ব্যাকএন্ড API (গুগলের জিওকোডিং 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> - আবার, নীতির নামটি পলিসি উল্লেখ করতে ব্যবহৃত হয় যখন এটি একটি প্রবাহে ব্যবহৃত হয়।
• <উৎস > - সার্ভিসকলআউট নীতিতে আমরা যে প্রতিক্রিয়া ভেরিয়েবল তৈরি করেছি তা নির্দিষ্ট করে। এটি সেই পরিবর্তনশীল যা থেকে এই নীতি ডেটা বের করে।
• <VariablePrefix> - পরিবর্তনশীল উপসর্গ এই নীতিতে তৈরি অন্যান্য ভেরিয়েবলের জন্য একটি নামস্থান নির্দিষ্ট করে। উপসর্গ যে কোনো নাম হতে পারে, এজ এর পূর্বনির্ধারিত ভেরিয়েবল দ্বারা সংজ্ঞায়িত সংরক্ষিত নাম ব্যতীত।
• <JSONPayload> - এই উপাদানটি আমাদের আগ্রহের প্রতিক্রিয়া ডেটা পুনরুদ্ধার করে এবং নামযুক্ত ভেরিয়েবলে রাখে। আসলে, জিওকোডিং API অক্ষাংশ এবং দ্রাঘিমাংশের চেয়ে অনেক বেশি তথ্য প্রদান করে। যাইহোক, এই নমুনার জন্য আমাদের প্রয়োজন একমাত্র মান। আপনি API এর ডকুমেন্টেশনে জিওকোডিং 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 , যা প্রয়োজন এবং সত্য বা মিথ্যা হতে হবে। এই মুহুর্তে লক্ষ্য করার সবচেয়ে গুরুত্বপূর্ণ বিষয় হল যে আমরা এখানে যে অনুরোধ বার্তা তৈরি করি তার জন্য কোনো ServiceCallout প্রয়োজন হয় না। আমাদের এই মুহুর্তে একটি ServiceCallout থেকে দ্বিতীয় API কল করার দরকার নেই কারণ আমরা প্রক্সির TargetEndpoint থেকে ব্যাকএন্ড API কল করতে পারি। আপনি যদি এটি সম্পর্কে চিন্তা করেন, তাহলে আমাদের কাছে Google Elevations API কল করার জন্য প্রয়োজনীয় সমস্ত ডেটা রয়েছে এই API প্রক্সির জন্য কনফিগার করা RouteRule অনুসরণ করে TargetEndpoint-এ। TargetEndpoint দূরবর্তী API এর সাথে সংযোগ পরিচালনা করে। (মনে রাখবেন যে এলিভেশন এপিআই-এর URL টার্গেটএন্ডপয়েন্টের জন্য HTTP সংযোগে সংজ্ঞায়িত করা হয়েছে। যদি আপনি আরও জানতে চান তাহলে উচ্চতা API ডকুমেন্টেশন। আমরা পূর্বে যে ক্যোয়ারীপ্যারামগুলি সংরক্ষণ করেছি, country এবং postalcode , এখন আর প্রয়োজন নেই, তাই আমরা সেগুলিকে এখানে সরিয়ে দিই। .

সংক্ষিপ্ত বিরতি: প্রবাহে ফিরে যান

এই মুহুর্তে, আপনি ভাবতে পারেন কেন আমরা অন্য সার্ভিসকলআউট নীতি তৈরি করছি না। সব পরে, আমরা আরেকটি বার্তা তৈরি. কিভাবে সেই বার্তাটি লক্ষ্যে পাঠানো হয়, 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-তে সৃজনশীল কার্যকারিতা যোগ করার জন্য ব্যবহৃত হয়।