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

Class Cache

Odwołanie do konkretnej pamięci podręcznej.

Ta klasa pozwala wstawiać i pobierać elementy z pamięci podręcznej oraz je z niej usuwać. Może to być szczególnie przydatne, gdy chcesz mieć stały dostęp do drogich lub powolnych zasobów. Przykład: Załóżmy, że masz na stronie example.com kanał RSS, którego pobranie trwa 20 sekund, ale chcesz przyspieszyć na przeciętny dostęp do danych.

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ędzie bardzo szybko, dopóki element nie 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 danego klucza lub wartość null, jeśli nie można go znaleźć.
`getAll(keys)`	`Object`	Zwraca obiekt JavaScript zawierający wszystkie pary klucz-wartość znalezione w pamięci podręcznej dla tablicy klawiszy.
`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 zbiór par klucz/wartość do pamięci podręcznej.
`putAll(values, expirationInSeconds)`	`void`	Dodaje do pamięci podręcznej zbiór par klucz-wartość z czasem wygaśnięcia (w sekundach).
`remove(key)`	`void`	Usuwa wpis z pamięci podręcznej przy użyciu 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 danego klucza lub wartość null, jeśli nie można go znaleźć.

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

Powrót

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

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

Powrót

Object – obiekt JavaScriptu zawierający pary klucz-wartość dla 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ć każdy klucz to 100 KB. Wartość wygasa w pamięci podręcznej po 600 sekundach (10 minutach).

Limit elementów w pamięci podręcznej wynosi 1000. Jeśli zapisanych jest więcej niż 1000 elementów, w pamięci podręcznej 900 produktów, które są najdalsze do 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 zapisania wartości
`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ć każdy klucz to 100 KB. Podany czas ważności jest tylko propozycją. dane z pamięci podręcznej mogą być usunięte przed tą datą, jeśli w pamięci podręcznej znajduje się duża ilość danych.

// 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 zapisania wartości
`value`	`String`	wartość do pamięci podręcznej
`expirationInSeconds`	`Integer`	maksymalny czas (w sekundach), przez jaki wartość pozostaje w pamięci podręcznej. minimalna długość to 1 sekunda, a maksymalna – 21 600 sekund (6 godzin).

`putAll(values)`

Dodaje zbiór par klucz/wartość do pamięci podręcznej.

Przypomina powtarzające się wezwania „put”, ale jest bardziej efektywne, ponieważ wysyła tylko jedno wywołanie memcache do ustawiania wszystkich wartości. Maksymalna długość klucza to 250 znaków. Maksymalna wartość ilość danych, które można przechowywać na jednym kluczu, wynosi 100 KB. Wartości wygasną w pamięci podręcznej po upływie 600 sekund (10 minut).

// 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 ciągu znaków

Zobacz też

put(key, value)

`putAll(values, expirationInSeconds)`

Dodaje do pamięci podręcznej zbiór par klucz-wartość z czasem wygaśnięcia (w sekundach).

Przypomina powtarzające się wezwania „put”, ale jest bardziej efektywne, ponieważ wysyła tylko jedno wywołanie memcache do ustawiania wszystkich wartości. Maksymalna długość klucza to 250 znaków. Maksymalna wartość ilość danych, które można przechowywać na jednym kluczu, wynosi 100 KB. Podany czas ważności to tylko sugestia; i mogą zostać usunięte wcześniej, jeśli w pamięci podręcznej znajduje się duża ilość danych.

// 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 JavaScriptu zawierający klucze i wartości ciągu znaków
`expirationInSeconds`	`Integer`	Maksymalny czas, przez jaki wartość pozostaje w pamięci podręcznej (w sekundach). minimalny dozwolony czas wygaśnięcia to 1 sekunda, a maksymalny 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 przy użyciu 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