Class Cache

ক্যাশে

একটি নির্দিষ্ট ক্যাশের উল্লেখ।

এই ক্লাসটি আপনাকে ক্যাশে আইটেম যোগ করতে, পুনরুদ্ধার করতে এবং মুছে ফেলতে সাহায্য করে। এটি বিশেষভাবে কার্যকর হতে পারে যখন আপনি কোনো ব্যয়বহুল বা ধীরগতির রিসোর্স ঘন ঘন ব্যবহার করতে চান। উদাহরণস্বরূপ, ধরুন example.com-এ আপনার একটি RSS ফিড আছে যা আনতে ২০ সেকেন্ড সময় লাগে, কিন্তু আপনি গড় অনুরোধে এর অ্যাক্সেস আরও দ্রুত করতে চান।

function getRssFeed() {
  const cache = CacheService.getScriptCache();
  const cached = cache.get('rss-feed-contents');
  if (cached != null) {
    return cached;
  }
  const result = UrlFetchApp.fetch(
      'http://example.com/my-slow-rss-feed.xml');  // takes 20 seconds
  const contents = result.getContentText();
  cache.put('rss-feed-contents', contents, 1500);  // cache for 25 minutes
  return contents;
}

আইটেমটি ক্যাশে না থাকলেও আপনাকে ২০ সেকেন্ড অপেক্ষা করতে হবে, কিন্তু ২৫ মিনিটে ক্যাশ থেকে আইটেমটির মেয়াদ শেষ না হওয়া পর্যন্ত পরবর্তী কলগুলো খুব দ্রুত হয়।

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
get(key) String|null প্রদত্ত কী-এর জন্য ক্যাশ করা মানটি পাওয়া যায়, অথবা কোনোটি খুঁজে না পাওয়া গেলে null ।
get All(keys) Object একটি কী-অ্যারে-র জন্য ক্যাশে-তে পাওয়া সমস্ত কী/ভ্যালু পেয়ার সম্বলিত একটি জাভাস্ক্রিপ্ট অবজেক্ট রিটার্ন করে।
put(key, value) void ক্যাশে একটি কী/ভ্যালু পেয়ার যোগ করে।
put(key, value, expirationInSeconds) void ক্যাশে একটি কী/ভ্যালু পেয়ার যোগ করে, যার একটি মেয়াদ শেষ হওয়ার সময় (সেকেন্ডে) থাকে।
put All(values) void ক্যাশে এক সেট কী/ভ্যালু পেয়ার যোগ করে।
put All(values, expirationInSeconds) void ক্যাশে এক সেট কী/ভ্যালু পেয়ার যোগ করে, যার একটি মেয়াদ শেষ হওয়ার সময় (সেকেন্ডে) থাকে।
remove(key) void প্রদত্ত কী ব্যবহার করে ক্যাশ থেকে একটি এন্ট্রি মুছে ফেলে।
remove All(keys) void ক্যাশ থেকে একগুচ্ছ এন্ট্রি মুছে ফেলে।

বিস্তারিত ডকুমেন্টেশন

get(key)

প্রদত্ত কী-এর জন্য ক্যাশ করা মানটি পাওয়া যায়, অথবা কোনোটি খুঁজে না পাওয়া গেলে null ।

// Gets the value from the cache for the key 'foo'.
const value = CacheService.getScriptCache().get('foo');

প্যারামিটার

নাম প্রকার বর্ণনা
key String ক্যাশে খুঁজে বের করার জন্য কী-টি।

ফেরত

String|null — ক্যাশে করা মান, অথবা কোনোটি খুঁজে না পাওয়া গেলে null ।

getAll(keys)

একটি কী-অ্যারে-র জন্য ক্যাশে-তে পাওয়া সমস্ত কী/ভ্যালু পেয়ার সম্বলিত একটি জাভাস্ক্রিপ্ট অবজেক্ট রিটার্ন করে।

// Gets a set of values from the cache
const values = CacheService.getDocumentCache().getAll(['foo', 'x', 'missing']);
// If there were values in the cache for 'foo' and 'x' but not 'missing', then
// 'values' is: {'foo': 'somevalue', 'x': 'othervalue'}

প্যারামিটার

নাম প্রকার বর্ণনা
keys String[] অনুসন্ধানের চাবিগুলো।

ফেরত

Object — একটি জাভাস্ক্রিপ্ট অবজেক্ট, যা ক্যাশে থাকা সমস্ত কী-এর জন্য কী/ভ্যালু জোড়া ধারণ করে।

আরও দেখুন

put(key, value)

ক্যাশে একটি কী/ভ্যালু পেয়ার যোগ করে।

একটি কী-এর সর্বোচ্চ দৈর্ঘ্য ২৫০ অক্ষর। প্রতিটি কী-এর জন্য সর্বোচ্চ ১০০ কিলোবাইট ডেটা সংরক্ষণ করা যায়। মানটি ৬০০ সেকেন্ড (১০ মিনিট) পর ক্যাশ থেকে মেয়াদোত্তীর্ণ হয়ে যায়।

ক্যাশে রাখা আইটেমের সর্বোচ্চ সীমা হলো ১,০০০। যদি ১,০০০-এর বেশি আইটেম লেখা হয়, তবে ক্যাশে মেয়াদ শেষ হতে সবচেয়ে দেরি থাকা ৯০০টি আইটেম সংরক্ষণ করে। এই সীমা পরিবর্তিত হতে পারে।

const cache = CacheService.getScriptCache();
// Puts the value 'bar' into the cache using the key 'foo'
cache.put('foo', 'bar');

প্যারামিটার

নাম প্রকার বর্ণনা
key String মানটি সংরক্ষণ করার জন্য কী।
value String যে মানটি ক্যাশ করা হবে।

put(key, value, expirationInSeconds)

ক্যাশে একটি কী/ভ্যালু পেয়ার যোগ করে, যার একটি মেয়াদ শেষ হওয়ার সময় (সেকেন্ডে) থাকে।

একটি কী-এর সর্বোচ্চ দৈর্ঘ্য ২৫০ ক্যারেক্টার। প্রতি কী-তে সর্বোচ্চ ১০০ কিলোবাইট ডেটা সংরক্ষণ করা যায়। নির্দিষ্ট মেয়াদোত্তীর্ণের সময়টি শুধুমাত্র একটি পরামর্শ; প্রচুর পরিমাণে ডেটা ক্যাশ করা হলে এই সময়ের আগেই ক্যাশ করা ডেটা মুছে ফেলা হতে পারে।

ক্যাশে রাখা আইটেমের সর্বোচ্চ সীমা হলো ১,০০০। যদি ১,০০০-এর বেশি আইটেম লেখা হয়, তবে ক্যাশে মেয়াদ শেষ হতে সবচেয়ে দেরি থাকা ৯০০টি আইটেম সংরক্ষণ করে। এই সীমা পরিবর্তিত হতে পারে।

// Puts the value 'bar' into the cache using the key 'foo', but only for the
// next 20 seconds.
CacheService.getScriptCache().put('foo', 'bar', 20);

প্যারামিটার

নাম প্রকার বর্ণনা
key String মানটি সংরক্ষণ করার জন্য কী।
value String যে মানটি ক্যাশ করা হবে।
expiration In Seconds Integer ক্যাশে মানটি সর্বোচ্চ কতক্ষণ থাকে, তা সেকেন্ডে পরিমাপ করা হয়। সর্বনিম্ন সময় হলো ১ সেকেন্ড এবং সর্বোচ্চ সময় হলো ২১৬০০ সেকেন্ড (৬ ঘণ্টা)।

putAll(values)

ক্যাশে এক সেট কী/ভ্যালু পেয়ার যোগ করে।

বারবার 'put' কল করার মতোই, কিন্তু এটি আরও বেশি কার্যকর কারণ এতে মাত্র একবার কল করা হয় এবং প্রতিটি কী-এর জন্য ১০০ কিলোবাইট ডেটা সংরক্ষণ করা যায়। মানগুলো ৬০০ সেকেন্ড (১০ মিনিট) পর ক্যাশ থেকে মুছে যায়।

ক্যাশে রাখা আইটেমের সর্বোচ্চ সীমা হলো ১,০০০। যদি ১,০০০-এর বেশি আইটেম লেখা হয়, তবে ক্যাশে মেয়াদ শেষ হতে সবচেয়ে দেরি থাকা ৯০০টি আইটেম সংরক্ষণ করে। এই সীমা পরিবর্তিত হতে পারে।

// Puts a set of values into the cache with the keys 'foo', 'x', and 'key'.
const values = {
  foo: 'bar',
  x: 'y',
  key: 'value',
};
CacheService.getUserCache().putAll(values);

প্যারামিটার

নাম প্রকার বর্ণনা
values Object একটি জাভাস্ক্রিপ্ট অবজেক্ট, যাতে স্ট্রিং কী এবং ভ্যালু রয়েছে।

আরও দেখুন

putAll(values, expirationInSeconds)

ক্যাশে এক সেট কী/ভ্যালু পেয়ার যোগ করে, যার একটি মেয়াদ শেষ হওয়ার সময় (সেকেন্ডে) থাকে।

বারবার 'put' কল করার মতোই, কিন্তু এটি আরও বেশি কার্যকর কারণ সমস্ত মান সেট করার জন্য এটি মেমক্যাশ সার্ভারে মাত্র একবার কল করে। একটি কী-এর সর্বোচ্চ দৈর্ঘ্য হলো ২৫০ ক্যারেক্টার। প্রতি কী-তে সর্বোচ্চ ১০০ কিলোবাইট ডেটা সংরক্ষণ করা যায়। নির্দিষ্ট মেয়াদোত্তীর্ণের সময়টি শুধুমাত্র একটি পরামর্শ; প্রচুর পরিমাণে ডেটা ক্যাশ করা হলে এই সময়ের আগেই ক্যাশ করা ডেটা মুছে ফেলা হতে পারে।

ক্যাশে রাখা আইটেমের সর্বোচ্চ সীমা হলো ১,০০০। যদি ১,০০০-এর বেশি আইটেম লেখা হয়, তবে ক্যাশে মেয়াদ শেষ হতে সবচেয়ে দেরি থাকা ৯০০টি আইটেম সংরক্ষণ করে। এই সীমা পরিবর্তিত হতে পারে।

// Puts a set of values into the cache with the keys 'foo', 'x', and 'key'.
const values = {
  foo: 'bar',
  x: 'y',
  key: 'value',
};
CacheService.getUserCache().putAll(values, 20);

প্যারামিটার

নাম প্রকার বর্ণনা
values Object একটি জাভাস্ক্রিপ্ট অবজেক্ট, যাতে স্ট্রিং কী এবং ভ্যালু রয়েছে।
expiration In Seconds Integer ক্যাশে মানটি সর্বোচ্চ কতক্ষণ থাকবে, তা সেকেন্ডে পরিমাপ করা হয়। সর্বনিম্ন অনুমোদিত মেয়াদ হলো ১ সেকেন্ড এবং সর্বোচ্চ অনুমোদিত মেয়াদ হলো ২১৬০০ সেকেন্ড (৬ ঘণ্টা)। ডিফল্ট মেয়াদ হলো ৬০০ সেকেন্ড (১০ মিনিট)।

আরও দেখুন

remove(key)

প্রদত্ত কী ব্যবহার করে ক্যাশ থেকে একটি এন্ট্রি মুছে ফেলে।

// Removes any cache entries for 'foo'
CacheService.getUserCache().remove('foo');

প্যারামিটার

নাম প্রকার বর্ণনা
key String ক্যাশ থেকে মুছে ফেলার চাবি।

removeAll(keys)

ক্যাশ থেকে একগুচ্ছ এন্ট্রি মুছে ফেলে।

// Removes entries from the cache with keys 'foo' and 'x'
CacheService.getDocumentCache().removeAll(['foo', 'x']);

প্যারামিটার

নাম প্রকার বর্ণনা
keys String[] অপসারণ করার জন্য কী-গুলোর অ্যারে।