Node.js-এ ক্যাশে অ্যাক্সেস করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য

আপনি একটি Node.js অ্যাপ্লিকেশনের মধ্যে থেকে এজ বিতরণকৃত ক্যাশে অ্যাক্সেস করতে apigee-access মডিউল ব্যবহার করতে পারেন। মডিউলটিতে ক্যাশে পাওয়ার এবং ডেটা স্থাপন , পাওয়ার এবং অপসারণের পদ্ধতি অন্তর্ভুক্ত রয়েছে।

Apigee Edge বিতরণকৃত ক্যাশে আপনাকে স্ট্রিং বা অন্যান্য ডেটা সঞ্চয় করতে দেয়। বেশিরভাগ ক্যাশের মতো, এটি সর্বাধিক আকার সহ একটি সর্বনিম্ন-সম্প্রতি ব্যবহৃত ক্যাশে। Apigee Edge এর ভিতরে, ক্যাশে সমস্ত নোডের মধ্যে বিতরণ করা হয় যেখানে আপনার Node.js অ্যাপ্লিকেশনটি কার্যকর হয়। আপনি Apigee Edge API এর মাধ্যমে ক্যাশে পরিচালনা করতে পারেন। API ব্যবহার করে, আপনি ম্যানুয়ালি ক্যাশে রিসোর্স তৈরি করতে পারেন, অথবা আপনি ডিফল্ট রিসোর্স ব্যবহার করতে পারেন। Apigee এজ-এ ক্যাশিং-এর একটি ভূমিকার জন্য, এজ-এ পারসিস্টেন্স টুলগুলি দেখুন। বিতরণ করা ক্যাশে সম্পর্কে আরও জানতে, উদাহরণ দেখুন: সাধারণ উদ্দেশ্য ক্যাশিং ।

apigee-access মডিউল এবং এর অন্যান্য বৈশিষ্ট্যগুলির পরিচিতির জন্য, অ্যাপিজি-অ্যাক্সেস মডিউল ব্যবহার করা দেখুন।

পদ্ধতি

(1) getCache

var cache = apigee.getCache( cacheName );

একটি নামযুক্ত ক্যাশে সন্ধান করুন এবং প্রয়োজনে এটি তৈরি করুন। ফলস্বরূপ ক্যাশে বেশিরভাগ পরিস্থিতিতে উপযুক্ত কনফিগারেশন পরামিতিগুলির একটি পূর্ব-নির্ধারিত সেট ব্যবহার করে।

পরামিতি:

cacheName - একটি স্ট্রিং, ক্যাশের নাম। (ক্যাশ রিসোর্সের নাম নয়)।

রিটার্ন:

একটি ক্যাশে অবজেক্ট।

উদাহরণ: 

var apigee = require('apigee-access');
var cache = apigee.getCache('cache');

(2) getCache

var customCache = apigee.getCache( cacheName , options );

কনফিগারেশন অবজেক্টে নির্দিষ্ট করা একটি কাস্টম ক্যাশে রিসোর্স অ্যাক্সেস করুন। কিভাবে একটি ক্যাশে রিসোর্স তৈরি করতে হয় সে সম্পর্কে তথ্যের জন্য, একটি পরিবেশ ক্যাশে তৈরি এবং সম্পাদনা দেখুন।

পরামিতি:

cacheName - একটি স্ট্রিং, কাস্টম ক্যাশের নাম। (ক্যাশে রিসোর্সের নাম নয়)

অপশন - একটি কনফিগারেশন অবজেক্ট। বস্তুটি খালি হতে পারে, অথবা এতে নিম্নলিখিত ঐচ্ছিক পরামিতি থাকতে পারে:

  • resource : একটি Apigee "ক্যাশে রিসোর্স" এর নাম যেখানে ক্যাশে ডেটা সংরক্ষণ করা হয়। ক্যাশে রিসোর্স মেমরি বরাদ্দ এবং অন্যান্য ক্যাশে পরামিতি সূক্ষ্ম-টিউন করতে ব্যবহৃত হয়। নির্দিষ্ট না হলে, একটি ডিফল্ট সম্পদ ব্যবহার করা হবে। যদি ক্যাশে সংস্থানটি বিদ্যমান না থাকে, তবে পদ্ধতিটি একটি ত্রুটি ছুড়ে দেয়।

  • scope : সংঘর্ষ প্রতিরোধ করার জন্য ক্যাশে এন্ট্রিগুলি প্রিফিক্স করা হয়েছে কিনা তা নির্দিষ্ট করে। বৈধ মানগুলি global , application এবং exclusive ।

    • global : সমস্ত ক্যাশে এন্ট্রি একই Apigee "পরিবেশে" সমস্ত Node.js অ্যাপ্লিকেশন দ্বারা দেখা যেতে পারে৷

    • application : সমস্ত ক্যাশে এন্ট্রি সমস্ত Node.js ক্যাশে দেখা যেতে পারে যা একই Apigee Edge অ্যাপ্লিকেশনের অংশ।

    • exclusive : (ডিফল্ট) ক্যাশে এন্ট্রিগুলি শুধুমাত্র একই নামের একই অ্যাপ্লিকেশনে Node.js ক্যাশে দ্বারা দেখা যায়। এটি ডিফল্ট।

  • prefix : যদি ক্যাশ কী নামের একটি উপসর্গ থাকে, যেমনটি পপুলেট ক্যাশে নীতিতে বর্ণিত এবং ক্যাশে কীগুলির সাথে কাজ করা , এটি নির্দিষ্ট করতে এই প্যারামিটারটি ব্যবহার করুন। এজ স্বয়ংক্রিয়ভাবে উপসর্গ নামের সাথে একটি ডবল-আন্ডারস্কোর প্রত্যয় যোগ করে। তাই যদি একটি ক্যাশে কী "UserToken" উপসর্গ দিয়ে তৈরি করা হয়, তাহলে এখানে উল্লেখ করার উপসর্গটি হল "UserToken__"।

  • defaultTtl : একটি ক্যাশে এন্ট্রির জন্য বেঁচে থাকার ডিফল্ট সময় নির্দিষ্ট করে, সেকেন্ডে। যদি নির্দিষ্ট করা না থাকে তাহলে ক্যাশে রিসোর্সে ডিফল্ট TTL ব্যবহার করা হবে।

  • timeout : বিতরণ করা ক্যাশে থেকে ফলাফল আনতে কতক্ষণ অপেক্ষা করতে হবে, সেকেন্ডে। ডিফল্ট 30 সেকেন্ড। লেটেন্সি-সংবেদনশীল অ্যাপ্লিকেশানগুলি ক্যাশে পরিকাঠামো ওভারলোড হলে ধীর প্রতিক্রিয়ার সময় রোধ করার জন্য এটি হ্রাস করতে পারে৷

রিটার্ন:

একটি কাস্টম ক্যাশে অবজেক্ট।

উদাহরণ:

var apigee = require('apigee-access');
var customCache = apigee.getCache('doesNotMatter',
  { resource: 'MyCustomResource', scope: 'global', prefix: 'UserToken'} );
customCache.put("myCacheKey", "xyz");

এটি এই মত কনফিগার করা একটি LookupCache নীতির সাথে কাজ করে: 

<LookupCache name="Lookup-Cache-1">
  <CacheKey>
    <Prefix>UserToken</prefix>    
    <KeyFragment>myCacheKey</KeyFragment>
  </CacheKey>
  <CacheResource>MyCustomResource</CacheResource>
  <Scope>Global</Scope>
  <AssignTo>contextVariable</AssignTo>
</LookupCache>

রাখা

cache.put(' key ', data , ttl , function( error ));

একটি ক্যাশে ডেটা রাখুন।

পরামিতি:

  • key : (প্রয়োজনীয়) একটি স্ট্রিং যা ক্যাশে আইটেমটিকে অনন্যভাবে সনাক্ত করে। ক্যাশে কীগুলি 2 KB আকারে সীমাবদ্ধ৷

  • data : (প্রয়োজনীয়) একটি স্ট্রিং, বাফার বা অবজেক্ট যা ক্যাশে ডেটা উপস্থাপন করে। অন্য কোনো ডাটা টাইপ ত্রুটির কারণ হবে। সুবিধার জন্য, বস্তুগুলিকে "JSON.stringify" ব্যবহার করে একটি স্ট্রিংয়ে রূপান্তরিত করা হবে।

  • ttl : (ঐচ্ছিক) ক্যাশে ডেটা টিকে থাকার সর্বোচ্চ সময়, সেকেন্ডে। যদি নির্দিষ্ট করা না থাকে তাহলে একটি ডিফল্ট TTL ব্যবহার করা হবে।

  • callback : (ঐচ্ছিক) যদি নির্দিষ্ট করা থাকে, একটি ফাংশন যা একবার ক্যাশে নিরাপদে ডেটা থাকলে কল করা হবে। সন্নিবেশ ত্রুটি থাকলে এটিকে প্রথম প্যারামিটার হিসাবে একটি ত্রুটি অবজেক্টের সাথে কল করা হবে এবং অন্যথায় এটি কোন পরামিতি ছাড়াই কল করা হবে।

উদাহরণ: 

var apigee = require('apigee-access');
var cache = apigee.getCache();
// Insert a string into cache using the default TTL
cache.put('key1', 'Buenos dias, Mundo!');
// Insert a string into cache using a TTL of 120 seconds
cache.put('key2', 'Hello, World!', 120);
// Insert a string with the default TTL, and get notified when the insert is complete
cache.put('key3', 'Ciao, Mondo!', function(error) {
  // "error" will be falsy unless there was an error on insert
});
// Insert a string with a TTL of 600 seconds, and get notified when the insert is complete
cache.put('key4', 'Hallo Wereld!', 600, function(error) {
  // "error" will be falsy unless there was an error on insert
});

পেতে

cache.get(' key ', function(error, data));

একটি ক্যাশে থেকে ডেটা পুনরুদ্ধার করুন।

পরামিতি:

  • key (প্রয়োজনীয়): একটি স্ট্রিং যা ক্যাশে আইটেমটিকে অনন্যভাবে সনাক্ত করে।

    Apigee এজ পলিসি (যেমন পপুলেট ক্যাশে পলিসি ) থেকে ক্যাশে রাখা ক্যাশে এন্ট্রির জন্য, পলিসি এন্ট্রির জন্য কী তৈরি করে সেই নির্দিষ্ট উপায় থেকে অনুমান করে আপনাকে ক্যাশে কী তৈরি করতে হবে। এটি করার জন্য, আপনাকে জানতে হবে নীতিটি কীভাবে কনফিগার করা হয়েছে৷ ক্যাশে কীগুলির সাথে কাজ করার সময় নীতিগুলি দ্বারা ক্যাশে কীগুলি কীভাবে তৈরি করা হয় তা বর্ণনা করে, মনে রাখবেন যে আপনি স্কোপের সাথে সম্পর্কিত স্ট্রিং মানগুলি নির্দিষ্ট করবেন না; Node.js থেকে কলে, স্কোপ ইতিমধ্যেই প্রসঙ্গের অংশ।

  • callback (প্রয়োজনীয়): একটি ফাংশন যা ডেটা উপলব্ধ হলে কল করা হবে। ক্যাশে ডেটা থাকলে, এটি দ্বিতীয় প্যারামিটারে ফেরত দেওয়া হয়।

    • error - একটি ত্রুটি বস্তু। ক্যাশে থেকে পুনরুদ্ধার করার সময় যদি কোনও ত্রুটি থাকে তবে এখানে একটি ত্রুটি অবজেক্ট সেট করা হবে। অন্যথায় এই প্যারামিটারটি "অনির্ধারিত" তে সেট করা হবে।

    • data - ডেটা পুনরুদ্ধার করা হয়েছে, যদি থাকে। এটি চারটি মানের একটি হবে:

      • একটি স্ট্রিং সন্নিবেশ করা হলে, এটি একটি স্ট্রিং হবে.
      • যদি একটি বাফার সন্নিবেশ করা হয়, এটি একটি বাফার হবে.
      • যদি একটি বস্তু সন্নিবেশ করা হয়, এটি "JSON.stringify" দ্বারা উত্পাদিত বস্তুর JSON সংস্করণ ধারণকারী একটি স্ট্রিং হবে।
      • যদি কিছু না পাওয়া যায়, তাহলে এটি "অনির্ধারিত" হবে।

উদাহরণ: 

var apigee = require('apigee-access');
var cache = apigee.getCache();
cache.get('key', function(error, data) {
  // If there was an error, then "error" will be set.
  // If error is falsy, "data" is the item that was retrieved:
  //   - undefined, in the case of cache miss, or
  //   - a Buffer, or
  //   - a String
});

অপসারণ

cache.remove(' key ', function(error));

একটি ক্যাশে আইটেম অবৈধ. একবার একটি কী অবৈধ হয়ে গেলে, পরবর্তী get() অনুরোধগুলি "অনির্ধারিত" ফিরে আসবে যদি না অন্য একটি মান সন্নিবেশ করা হয়।

পরামিতি:

  • key (প্রয়োজনীয়): একটি স্ট্রিং যা অকার্যকর করতে ক্যাশে আইটেমটিকে অনন্যভাবে সনাক্ত করে।

    Apigee এজ পলিসি (যেমন পপুলেট ক্যাশে পলিসি ) থেকে ক্যাশে রাখা ক্যাশে এন্ট্রির জন্য, পলিসি এন্ট্রির জন্য কী তৈরি করে সেই নির্দিষ্ট উপায় থেকে অনুমান করে আপনাকে ক্যাশে কী তৈরি করতে হবে। এটি করার জন্য, আপনাকে জানতে হবে নীতিটি কীভাবে কনফিগার করা হয়েছে৷ ক্যাশে কীগুলির সাথে কাজ করার সময় নীতিগুলি দ্বারা ক্যাশে কীগুলি কীভাবে তৈরি করা হয় তা বর্ণনা করে, মনে রাখবেন যে আপনি স্কোপের সাথে সম্পর্কিত স্ট্রিং মানগুলি নির্দিষ্ট করবেন না; Node.js থেকে কলে, স্কোপ ইতিমধ্যেই প্রসঙ্গের অংশ।

  • callback (প্রয়োজনীয়): একটি কলব্যাক ফাংশন যা কোনো ত্রুটি থাকলে প্রথম প্যারামিটার হিসাবে একটি ত্রুটি বস্তুর সাথে কল করা হবে।

উদাহরণ:

var apigee = require('apigee-access');
var cache = apigee.getCache();
cache.remove('key', function(error) {
});