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');

المعلمات

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

الإرجاع

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

المعلمات

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

الإرجاع

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

انظر أيضًا

• get(key)

---

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');

المعلمات

الاسم	النوع	الوصف
key	String	المفتاح لتخزين القيمة تحت
value	String	القيمة التي سيتم تخزينها مؤقتًا

---

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

المعلمات

الاسم	النوع	الوصف
key	String	المفتاح لتخزين القيمة تحت
value	String	القيمة التي سيتم تخزينها مؤقتًا
expirationInSeconds	Integer	الحد الأقصى للوقت الذي تبقى فيه القيمة في ذاكرة التخزين المؤقت بالثواني. تشير رسالة الأشكال البيانية الحد الأدنى هو ثانية واحدة والحد الأقصى هو 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);

المعلمات

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

انظر أيضًا

• put(key, value)

---

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

المعلمات

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

انظر أيضًا

• put(key, value)

---

remove(key)

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

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

المعلمات

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

---

removeAll(keys)

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

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

المعلمات

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