Class Cache

ذاكرة التخزين المؤقت

مرجع إلى ذاكرة تخزين مؤقت معينة.

تسمح لك هذه الفئة بإدراج العناصر واستردادها وإزالتها من ذاكرة التخزين المؤقت. يمكن أن تظهر فائدة هذا بوضوح أكبر يكون مفيدًا بشكل خاص عندما تريد الوصول المتكرر إلى مورد باهظ الثمن أو بطيء. على سبيل المثال: لنفترض أنّ لديك خلاصة RSS على example.com يستغرق استرجاعها 20 ثانية، لكنّك تريد تسريع الوصول في متوسط طلب.

function getRssFeed() {
  var cache = CacheService.getScriptCache();
  var cached = cache.get("rss-feed-contents");
  if (cached != null) {
    return cached;
  }
  var result = UrlFetchApp.fetch("http://example.com/my-slow-rss-feed.xml"); // takes 20 seconds
  var contents = result.getContentText();
  cache.put("rss-feed-contents", contents, 1500); // cache for 25 minutes
  return contents;
}
يجب الانتظار لمدة 20 ثانية إذا لم يكن العنصر في ذاكرة التخزين المؤقت، ولكن في المكالمات اللاحقة سيكون سريعًا جدًا إلى أن تنتهي صلاحية العنصر من ذاكرة التخزين المؤقت خلال 25 دقيقة.

الطُرق

الطريقةنوع الإرجاعوصف قصير
get(key)Stringتحصل على القيمة المخزّنة مؤقتًا للمفتاح المحدد أو قيمة فارغة إذا لم يتم العثور على أي منها.
getAll(keys)Objectتعرض كائن JavaScript يحتوي على جميع أزواج المفتاح/القيمة في ذاكرة التخزين المؤقت لمصفوفة من المفاتيح.
put(key, value)voidلإضافة زوج المفتاح/القيمة إلى ذاكرة التخزين المؤقت
put(key, value, expirationInSeconds)voidتضيف زوج المفتاح/القيمة إلى ذاكرة التخزين المؤقت، مع وقت انتهاء الصلاحية (بالثواني).
putAll(values)voidتضيف مجموعة من أزواج المفتاح/القيمة إلى ذاكرة التخزين المؤقت.
putAll(values, expirationInSeconds)voidتضيف مجموعة من أزواج المفتاح/القيمة إلى ذاكرة التخزين المؤقت، مع وقت انتهاء الصلاحية (بالثواني).
remove(key)voidلإزالة إدخال من ذاكرة التخزين المؤقت باستخدام المفتاح المحدّد.
removeAll(keys)voidإزالة مجموعة من الإدخالات من ذاكرة التخزين المؤقت

الوثائق التفصيلية

get(key)

تحصل على القيمة المخزّنة مؤقتًا للمفتاح المحدد أو قيمة فارغة إذا لم يتم العثور على أي منها.

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

المعلمات

الاسمالنوعالوصف
keyStringالمفتاح للبحث في ذاكرة التخزين المؤقت

الإرجاع

String — القيمة المخزّنة مؤقتًا أو تكون فارغة إذا لم يتم العثور على أي منها


getAll(keys)

تعرض كائن JavaScript يحتوي على جميع أزواج المفتاح/القيمة في ذاكرة التخزين المؤقت لمصفوفة من المفاتيح.

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

المعلمات

الاسمالنوعالوصف
keysString[]مفاتيح البحث

الإرجاع

Object - كائن JavaScript يحتوي على أزواج المفتاح/القيمة لجميع المفاتيح التي تم العثور عليها في ذاكرة التخزين المؤقت

انظر أيضًا


put(key, value)

لإضافة زوج المفتاح/القيمة إلى ذاكرة التخزين المؤقت

يبلغ الحد الأقصى لطول المفتاح 250 حرفًا. الحد الأقصى لمقدار البيانات التي يمكن تخزينها لكل مفتاح 100 كيلوبايت. ستنتهي صلاحية القيمة من ذاكرة التخزين المؤقت بعد 600 ثانية (10 دقائق).

والحدّ الأقصى للعناصر المخزّنة مؤقتًا هو 1,000. في حال كتابة أكثر من 1,000 عنصر، يتم تخزين ذاكرة التخزين المؤقت الـ 900 عنصر الأبعد من تاريخ انتهاء الصلاحية. وقد يتغير هذا الحد الأقصى.

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

المعلمات

الاسمالنوعالوصف
keyStringالمفتاح لتخزين القيمة تحت
valueStringالقيمة التي سيتم تخزينها مؤقتًا

put(key, value, expirationInSeconds)

تضيف زوج المفتاح/القيمة إلى ذاكرة التخزين المؤقت، مع وقت انتهاء الصلاحية (بالثواني).

يبلغ الحد الأقصى لطول المفتاح 250 حرفًا. الحد الأقصى لمقدار البيانات التي يمكن تخزينها لكل مفتاح 100 كيلوبايت. وقت انتهاء الصلاحية المحدّد هو مجرد اقتراح. البيانات المخزنة مؤقتًا قبل هذا الوقت إذا تم تخزين الكثير من البيانات في ذاكرة التخزين المؤقت.

والحدّ الأقصى للعناصر المخزّنة مؤقتًا هو 1,000. في حال كتابة أكثر من 1,000 عنصر، يتم تخزين ذاكرة التخزين المؤقت الـ 900 عنصر الأبعد من تاريخ انتهاء الصلاحية. وقد يتغير هذا الحد الأقصى.

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

المعلمات

الاسمالنوعالوصف
keyStringالمفتاح لتخزين القيمة تحت
valueStringالقيمة التي سيتم تخزينها مؤقتًا
expirationInSecondsIntegerالحد الأقصى للوقت الذي تبقى فيه القيمة في ذاكرة التخزين المؤقت بالثواني. تشير رسالة الأشكال البيانية الحد الأدنى هو ثانية واحدة والحد الأقصى هو 21600 ثانية (6 ساعات).

putAll(values)

تضيف مجموعة من أزواج المفتاح/القيمة إلى ذاكرة التخزين المؤقت.

وهذا الأمر أشبه بالاستدعاءات المتكررة لعبارة "put"، إلا أنها أكثر فعالية لأنها تجري اتصالاً واحدًا فقط خادم memcache لتعيين جميع القيم. يبلغ الحد الأقصى لطول المفتاح 250 حرفًا. الحد الأقصى مقدار البيانات التي يمكن تخزينها لكل مفتاح 100 كيلوبايت. ستنتهي صلاحية القيم من ذاكرة التخزين المؤقت بعد 600 ثانية (10 دقائق).

والحدّ الأقصى للعناصر المخزّنة مؤقتًا هو 1,000. في حال كتابة أكثر من 1,000 عنصر، يتم تخزين ذاكرة التخزين المؤقت الـ 900 عنصر الأبعد من تاريخ انتهاء الصلاحية. وقد يتغير هذا الحد الأقصى.

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

المعلمات

الاسمالنوعالوصف
valuesObjectكائن JavaScript يحتوي على مفاتيح وقيم سلاسل

انظر أيضًا


putAll(values, expirationInSeconds)

تضيف مجموعة من أزواج المفتاح/القيمة إلى ذاكرة التخزين المؤقت، مع وقت انتهاء الصلاحية (بالثواني).

وهذا الأمر أشبه بالاستدعاءات المتكررة لعبارة "put"، إلا أنها أكثر فعالية لأنها تجري اتصالاً واحدًا فقط خادم memcache لتعيين جميع القيم. يبلغ الحد الأقصى لطول المفتاح 250 حرفًا. الحد الأقصى مقدار البيانات التي يمكن تخزينها لكل مفتاح 100 كيلوبايت. وقت انتهاء الصلاحية المحدد هو فقط اقتراح؛ البيانات المخزنة مؤقتًا قبل هذا الوقت إذا تم تخزين الكثير من البيانات مؤقتًا.

والحدّ الأقصى للعناصر المخزّنة مؤقتًا هو 1,000. في حال كتابة أكثر من 1,000 عنصر، يتم تخزين ذاكرة التخزين المؤقت الـ 900 عنصر الأبعد من تاريخ انتهاء الصلاحية. وقد يتغير هذا الحد الأقصى.

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

المعلمات

الاسمالنوعالوصف
valuesObjectكائن JavaScript يحتوي على مفاتيح وقيم سلاسل
expirationInSecondsIntegerالحد الأقصى لوقت بقاء القيمة في ذاكرة التخزين المؤقت بالثواني أدنى حد لانتهاء الصلاحية المسموح به هو ثانية واحدة، والحد الأقصى المسموح به لانتهاء الصلاحية هو 21600 ثانية (6 ساعات). تاريخ انتهاء الصلاحية التلقائي هو 600 ثانية (10 دقائق).

انظر أيضًا


remove(key)

لإزالة إدخال من ذاكرة التخزين المؤقت باستخدام المفتاح المحدّد.

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

المعلمات

الاسمالنوعالوصف
keyStringالمفتاح الذي تريد إزالته من ذاكرة التخزين المؤقت

removeAll(keys)

إزالة مجموعة من الإدخالات من ذاكرة التخزين المؤقت

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

المعلمات

الاسمالنوعالوصف
keysString[]صفيف المفاتيح المطلوب إزالتها