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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
get(key) | String | Belirtilen anahtar için önbelleğe alınmış değeri veya herhangi bir anahtar bulunamadıysa null değerini alır. |
getAll(keys) | Object | 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. |
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) | void | Verilen anahtarı kullanarak bir girişi önbellekten kaldırır. |
removeAll(keys) | void | Bir 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
Ad | Tür | Açıklama |
---|---|---|
key | String | ö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
Ad | Tür | Açıklama |
---|---|---|
keys | String[] | ö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
Ad | Tür | Açıklama |
---|---|---|
key | String | değeri depolama anahtarını |
value | String | ö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
Ad | Tür | Açıklama |
---|---|---|
key | String | değeri depolama anahtarını |
value | String | önbelleğe alınacak değer |
expirationInSeconds | Integer | değ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
Ad | Tür | Açıklama |
---|---|---|
values | Object | dize 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
Ad | Tür | Açıklama |
---|---|---|
values | Object | Dize anahtarları ve değerleri içeren JavaScript Nesnesi |
expirationInSeconds | Integer | Değ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
Ad | Tür | Açıklama |
---|---|---|
key | String | ö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
Ad | Tür | Açıklama |
---|---|---|
keys | String[] | kaldırılacak anahtar dizisi |