Odniesienie do konkretnej pamięci podręcznej.
Ta klasa umożliwia wstawianie elementów z pamięci podręcznej, ich pobieranie i usuwanie. Jest to szczególnie przydatne, gdy chcesz mieć częsty dostęp do drogich lub powolnych zasobów. Załóżmy na przykład, że masz kanał RSS na stronie example.com, którego pobieranie zajmuje 20 sekund, ale chcesz przyspieszyć dostęp w przypadku przeciętnego żądania.
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; }Jeśli elementu nie ma w pamięci podręcznej, musisz odczekać 20 sekund, ale kolejne wywołania będą bardzo szybkie, aż element zniknie z pamięci podręcznej w ciągu 25 minut.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
get(key) | String | Pobiera wartość z pamięci podręcznej dla danego klucza lub wartość null, jeśli nie znaleziono żadnego klucza. |
getAll(keys) | Object | Zwraca obiekt JavaScript zawierający wszystkie pary klucz/wartość znalezione w pamięci podręcznej dla tablicy kluczy. |
put(key, value) | void | Dodaje parę klucz/wartość do pamięci podręcznej. |
put(key, value, expirationInSeconds) | void | Dodaje do pamięci podręcznej parę klucz/wartość z czasem wygaśnięcia (w sekundach). |
putAll(values) | void | Dodaje do pamięci podręcznej zestaw par klucz/wartość. |
putAll(values, expirationInSeconds) | void | Dodaje do pamięci podręcznej zestaw par klucz/wartość z czasem wygaśnięcia (w sekundach). |
remove(key) | void | Usuwa wpis z pamięci podręcznej za pomocą podanego klucza. |
removeAll(keys) | void | Usuwa zbiór wpisów z pamięci podręcznej. |
Szczegółowa dokumentacja
get(key)
Pobiera wartość z pamięci podręcznej dla danego klucza lub wartość null, jeśli nie znaleziono żadnego klucza.
// Gets the value from the cache for the key 'foo'. var value = cache.get('foo');
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | klucz do wyszukania w pamięci podręcznej |
Powroty
String
– wartość z pamięci podręcznej lub wartość null, jeśli nie znaleziono żadnej wartości.
getAll(keys)
Zwraca obiekt JavaScript zawierający wszystkie pary klucz/wartość znalezione w pamięci podręcznej dla tablicy kluczy.
// 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'}
Parametry
Nazwa | Typ | Opis |
---|---|---|
keys | String[] | klucze do wyszukania |
Powroty
Object
– obiekt JavaScript zawierający pary klucz/wartość wszystkich kluczy znalezionych w pamięci podręcznej.
Zobacz też
put(key, value)
Dodaje parę klucz/wartość do pamięci podręcznej.
Maksymalna długość klucza to 250 znaków. Maksymalna ilość danych, które można przechowywać na klucz, to 100 KB. Wartość wygaśnie z pamięci podręcznej po 600 sekundach (10 minutach).
W przypadku elementów z pamięci podręcznej limit wynosi 1000. Jeśli zapisanych jest więcej niż 1000 elementów, w pamięci podręcznej zostanie zapisanych 900 elementów najdalej od daty wygaśnięcia. Ten limit może się zmienić.
// Puts the value 'bar' into the cache using the key 'foo' cache.put('foo', 'bar');
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | klucz do przechowywania wartości w argumencie |
value | String | wartość do pamięci podręcznej |
put(key, value, expirationInSeconds)
Dodaje do pamięci podręcznej parę klucz/wartość z czasem wygaśnięcia (w sekundach).
Maksymalna długość klucza to 250 znaków. Maksymalna ilość danych, które można przechowywać na klucz, to 100 KB. Podany czas wygaśnięcia to tylko sugestia. Jeśli w pamięci podręcznej jest dużo danych, dane z pamięci podręcznej mogą zostać usunięte przed upływem tego czasu.
W przypadku elementów z pamięci podręcznej limit wynosi 1000. Jeśli zapisanych jest więcej niż 1000 elementów, w pamięci podręcznej zostanie zapisanych 900 elementów najdalej od daty wygaśnięcia. Ten limit może się zmienić.
// Puts the value 'bar' into the cache using the key 'foo', but only for the next 20 seconds. cache.put('foo', 'bar', 20);
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | klucz do przechowywania wartości w argumencie |
value | String | wartość do pamięci podręcznej |
expirationInSeconds | Integer | maksymalny czas w sekundach, przez który wartość pozostaje w pamięci podręcznej. Minimalny czas to 1 sekunda, a maksymalna 21 600 sekund (6 godzin). |
putAll(values)
Dodaje do pamięci podręcznej zestaw par klucz/wartość.
Podobne do powtarzających się wywołań „put”, ale skuteczniejsze, ponieważ powoduje ono tylko jedno wywołanie serwera memcache w celu ustawienia wszystkich wartości. Maksymalna długość klucza to 250 znaków. Maksymalna ilość danych, które można przechowywać na kluczu, to 100 KB. Wartości z pamięci podręcznej tracą ważność po 600 sekundach (10 minutach).
W przypadku elementów z pamięci podręcznej limit wynosi 1000. Jeśli zapisanych jest więcej niż 1000 elementów, w pamięci podręcznej zostanie zapisanych 900 elementów najdalej od daty wygaśnięcia. Ten limit może się zmienić.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | Object | obiekt JavaScript zawierający klucze i wartości w postaci ciągów znaków |
Zobacz też
putAll(values, expirationInSeconds)
Dodaje do pamięci podręcznej zestaw par klucz/wartość z czasem wygaśnięcia (w sekundach).
Podobne do powtarzających się wywołań „put”, ale skuteczniejsze, ponieważ powoduje ono tylko jedno wywołanie serwera memcache w celu ustawienia wszystkich wartości. Maksymalna długość klucza to 250 znaków. Maksymalna ilość danych, które można przechowywać na kluczu, to 100 KB. Podany czas wygaśnięcia to tylko sugestia. Jeśli w pamięci podręcznej jest dużo danych, dane z pamięci podręcznej mogą zostać usunięte przed upływem tego czasu.
W przypadku elementów z pamięci podręcznej limit wynosi 1000. Jeśli zapisanych jest więcej niż 1000 elementów, w pamięci podręcznej zostanie zapisanych 900 elementów najdalej od daty wygaśnięcia. Ten limit może się zmienić.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | Object | Obiekt JavaScript zawierający klucze i wartości ciągów znaków |
expirationInSeconds | Integer | Maksymalny czas pozostawania wartości w pamięci podręcznej (w sekundach). Minimalny dozwolony czas wygaśnięcia to 1 sekunda, a maksymalny dozwolony czas wygaśnięcia to 21 600 sekund (6 godzin). Domyślny czas wygaśnięcia to 600 sekund (10 minut). |
Zobacz też
remove(key)
Usuwa wpis z pamięci podręcznej za pomocą podanego klucza.
// Removes any cache entries for 'foo' cache.remove('foo');
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | klucz do usunięcia z pamięci podręcznej |
removeAll(keys)
Usuwa zbiór wpisów z pamięci podręcznej.
// Removes entries from the cache with keys 'foo' and 'x' cache.removeAll(['foo', 'x']);
Parametry
Nazwa | Typ | Opis |
---|---|---|
keys | String[] | tablica kluczy do usunięcia |