Class Cache

Önbellek

Belirli bir önbelleğe ilişkin referans.

Bu sınıf, önbelleğe öğe eklemenize, önbellekten öğe almanıza ve kaldırmanıza olanak tanır. Bu özellik, özellikle pahalı veya yavaş bir kaynağa sık sık erişmek istediğinizde kullanışlıdır. Örneğin, example.com adresinde, getirmesi 20 saniye süren bir RSS özet akışınız olduğunu ancak bunu hızlandırmak erişimi var.

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;
}
. Öğe önbellekte değilse ancak sonraki çağrılarda 20 saniye beklemeniz gerekir. öğenin süresi 25 dakika içinde önbellekten çıkana kadar çok hızlı bir şekilde çalışır.

Yöntemler

YöntemDönüş türüKısa açıklama
get(key)StringBelirtilen anahtar için önbelleğe alınmış değeri veya herhangi bir anahtar bulunamadıysa null değerini alır.
getAll(keys)ObjectBir dizi için önbellekte bulunan tüm anahtar/değer çiftlerini içeren JavaScript Nesnesi'ni döndürür: tuşlarını kullanın.
put(key, value)voidÖnbelleğe bir anahtar/değer çifti ekler.
put(key, value, expirationInSeconds)voidÖnbelleğe, geçerlilik süresi (saniye cinsinden) olan bir anahtar/değer çifti ekler.
putAll(values)voidÖnbelleğe bir anahtar/değer çifti kümesi ekler.
putAll(values, expirationInSeconds)voidÖnbelleğe, geçerlilik süresi (saniye cinsinden) ile birlikte bir anahtar/değer çifti grubu ekler.
remove(key)voidVerilen anahtarı kullanarak bir girişi önbellekten kaldırır.
removeAll(keys)voidBir giriş grubunu önbellekten kaldırır.

Ayrıntılı belgeler

get(key)

Belirtilen anahtar için önbelleğe alınmış değeri veya herhangi bir anahtar bulunamadıysa null değerini alır.

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

Parametreler

AdTürAçıklama
keyStringönbellekte arama anahtarı

Return

String — önbelleğe alınan değer veya herhangi bir değer bulunamazsa boş


getAll(keys)

Bir dizi için önbellekte bulunan tüm anahtar/değer çiftlerini içeren JavaScript Nesnesi'ni döndürür: tuşlarını kullanın.

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

Parametreler

AdTürAçıklama
keysString[]önemli noktaları,

Return

Object — Önbellekte bulunan tüm anahtarlara ait anahtar/değer çiftlerini içeren bir JavaScript Nesnesi

Aşağıdaki kaynakları da incelemenizi öneririz:


put(key, value)

Önbelleğe bir anahtar/değer çifti ekler.

Bir anahtarın maksimum uzunluğu 250 karakterdir. Depolanabilecek maksimum veri miktarı anahtar başına 100 KB'tır. Değerin süresi 600 saniye (10 dakika) sonra önbellekten kaldırılır.

Önbelleğe alınan öğeler için sınır 1.000'dir. 1.000'den fazla öğe yazılırsa önbellek, son 900 öğe olabilir. Bu sınır değişebilir.

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

Parametreler

AdTürAçıklama
keyStringdeğeri depolama anahtarını
valueStringönbelleğe alınacak değer

put(key, value, expirationInSeconds)

Önbelleğe, geçerlilik süresi (saniye cinsinden) olan bir anahtar/değer çifti ekler.

Bir anahtarın maksimum uzunluğu 250 karakterdir. Depolanabilecek maksimum veri miktarı anahtar başına 100 KB'tır. Belirtilen süre sonu yalnızca bir öneridir; önbelleğe alınmış veriler, önbelleğe alınmış olması gerekir.

Önbelleğe alınan öğeler için sınır 1.000'dir. 1.000'den fazla öğe yazılırsa önbellek, son 900 öğe olabilir. Bu sınır değişebilir.

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

Parametreler

AdTürAçıklama
keyStringdeğeri depolama anahtarını
valueStringönbelleğe alınacak değer
expirationInSecondsIntegerdeğerin önbellekte kaldığı maksimum süre (saniye cinsinden). İlgili içeriği oluşturmak için kullanılan minimum 1 saniye, maksimum 21.600 saniyedir (6 saat).

putAll(values)

Önbelleğe bir anahtar/değer çifti kümesi ekler.

"put" komutuna tekrarlanan çağrılara benzer, ancak memcache sunucusu kullanarak tüm değerleri ayarlayabilirsiniz. Bir anahtarın maksimum uzunluğu 250 karakterdir. Maksimum Anahtar başına depolanabilecek veri miktarı 100 KB'tır. Değerlerin süresi şu tarihten sonra önbellekten kaldırılır: 600 saniye (10 dakika).

Önbelleğe alınan öğeler için sınır 1.000'dir. 1.000'den fazla öğe yazılırsa önbellek, son 900 öğe olabilir. Bu sınır değişebilir.

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

Parametreler

AdTürAçıklama
valuesObjectdize anahtarları ve değerleri içeren bir JavaScript nesnesi

Aşağıdaki kaynakları da incelemenizi öneririz:


putAll(values, expirationInSeconds)

Önbelleğe, geçerlilik süresi (saniye cinsinden) ile birlikte bir anahtar/değer çifti grubu ekler.

"put" komutuna tekrarlanan çağrılara benzer, ancak memcache sunucusu kullanarak tüm değerleri ayarlayabilirsiniz. Bir anahtarın maksimum uzunluğu 250 karakterdir. Maksimum Anahtar başına depolanabilecek veri miktarı 100 KB'tır. Belirtilen son kullanma tarihi yalnızca öneriniz; Önbelleğe alınan veriler çok fazlaysa bu süre öncesinde kaldırılabilir.

Önbelleğe alınan öğeler için sınır 1.000'dir. 1.000'den fazla öğe yazılırsa önbellek, son 900 öğe olabilir. Bu sınır değişebilir.

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

Parametreler

AdTürAçıklama
valuesObjectDize anahtarları ve değerleri içeren JavaScript Nesnesi
expirationInSecondsIntegerDeğerin önbellekte kaldığı maksimum süre (saniye cinsinden) izin verilen minimum geçerlilik süresi 1 saniye, izin verilen maksimum süre sonu 21.600 saniyedir (6 saat). Varsayılan geçerlilik süresi 600 saniyedir (10 dakika).

Aşağıdaki kaynakları da incelemenizi öneririz:


remove(key)

Verilen anahtarı kullanarak bir girişi önbellekten kaldırır.

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

Parametreler

AdTürAçıklama
keyStringönbellekten kaldırılacak anahtar

removeAll(keys)

Bir giriş grubunu önbellekten kaldırır.

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

Parametreler

AdTürAçıklama
keysString[]kaldırılacak anahtar dizisi