Ta strona została przetłumaczona przez Cloud Translation API.

Class Cache

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ż

get(key)

`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.

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

// 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ż

put(key, value)

`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.

// 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ż

put(key, value)

`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