تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

المَعلمات

الاسم	Type	الوصف
`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'}

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

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

`put(key, value, expirationInSeconds)`

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

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

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

المَعلمات

الاسم	Type	الوصف
`key`	`String`	المفتاح لتخزين القيمة ضمن
`value`	`String`	القيمة المخزنة مؤقتًا
`expirationInSeconds`	`Integer`	الحد الأقصى للوقت الذي تظل فيه القيمة في ذاكرة التخزين المؤقت، بالثواني. يبلغ الحدّ الأدنى ثانية واحدة والحد الأقصى هو 21600 ثانية (6 ساعات).

`putAll(values)`

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

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

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

المَعلمات

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

يمكن أيضًا مراجعة

put(key, value)

`putAll(values, expirationInSeconds)`

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

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

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

المَعلمات

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

يمكن أيضًا مراجعة

put(key, value)

`remove(key)`

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

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

المَعلمات

الاسم	Type	الوصف
`key`	`String`	المفتاح المطلوب إزالته من ذاكرة التخزين المؤقت

`removeAll(keys)`

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

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

المَعلمات

الاسم	Type	الوصف
`keys`	`String[]`	صفيف المفاتيح لإزالة