Diese Seite wurde von der Cloud Translation API übersetzt.

Class Cache

Ein Verweis auf einen bestimmten Cache.

Mit dieser Klasse können Sie Elemente in einen Cache einfügen, daraus abrufen und daraus entfernen. Dabei kann es sich um besonders nützlich, wenn Sie häufig auf eine teure oder langsame Ressource zugreifen möchten. Beispiel: Angenommen, Sie haben einen RSS-Feed auf example.com, der in 20 Sekunden abgerufen wird, möchten aber den Vorgang beschleunigen. bei einer durchschnittlichen Anfrage.

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;
}

Sie müssen trotzdem 20 Sekunden warten, wenn sich das Element nicht im Cache befindet, aber nachfolgende Aufrufe ist sehr schnell, bis das Element nach 25 Minuten aus dem Cache entfernt wird.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`get(key)`	`String`	Ruft den im Cache gespeicherten Wert für den angegebenen Schlüssel ab oder null, wenn keiner gefunden wird.
`getAll(keys)`	`Object`	Gibt ein JavaScript-Objekt zurück, das alle im Cache gefundenen Schlüssel/Wert-Paare für ein Array von Schlüssel.
`put(key, value)`	`void`	Fügt dem Cache ein Schlüssel/Wert-Paar hinzu.
`put(key, value, expirationInSeconds)`	`void`	Fügt dem Cache ein Schlüssel/Wert-Paar mit einer Ablaufzeit (in Sekunden) hinzu.
`putAll(values)`	`void`	Fügt dem Cache eine Reihe von Schlüssel/Wert-Paaren hinzu.
`putAll(values, expirationInSeconds)`	`void`	Fügt dem Cache einen Satz von Schlüssel/Wert-Paaren mit einer Ablaufzeit (in Sekunden) hinzu.
`remove(key)`	`void`	Entfernt einen Eintrag mit dem angegebenen Schlüssel aus dem Cache.
`removeAll(keys)`	`void`	Entfernt eine Reihe von Einträgen aus dem Cache.

Detaillierte Dokumentation

`get(key)`

Ruft den im Cache gespeicherten Wert für den angegebenen Schlüssel ab oder null, wenn keiner gefunden wird.

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

Parameter

Name	Typ	Beschreibung
`key`	`String`	Schlüssel, der im Cache gesucht werden soll

Rückflug

String: der im Cache gespeicherte Wert oder null, wenn keiner gefunden wurde

`getAll(keys)`

Gibt ein JavaScript-Objekt zurück, das alle im Cache gefundenen Schlüssel/Wert-Paare für ein Array von Schlüssel.

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

Parameter

Name	Typ	Beschreibung
`keys`	`String[]`	die Schlüssel für die Suche

Rückflug

Object: Ein JavaScript-Objekt, das die Schlüssel/Wert-Paare für alle im Cache gefundenen Schlüssel enthält

Weitere Informationen

get(key)

`put(key, value)`

Fügt dem Cache ein Schlüssel/Wert-Paar hinzu.

Die maximale Länge eines Schlüssels beträgt 250 Zeichen. Die maximale Datenmenge, die gespeichert werden kann pro Schlüssel beträgt 100 KB. Der Wert läuft nach 600 Sekunden (10 Minuten) aus dem Cache ab.

Die Obergrenze für im Cache gespeicherte Elemente beträgt 1.000. Werden mehr als 1.000 Elemente geschrieben, speichert der Cache die am weitesten vom Ablaufdatum entfernt sind. Dieses Limit kann sich ändern.

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

Parameter

Name	Typ	Beschreibung
`key`	`String`	den Schlüssel zum Speichern des Werts unter
`value`	`String`	Wert, der im Cache gespeichert werden soll

`put(key, value, expirationInSeconds)`

Fügt dem Cache ein Schlüssel/Wert-Paar mit einer Ablaufzeit (in Sekunden) hinzu.

Die maximale Länge eines Schlüssels beträgt 250 Zeichen. Die maximale Datenmenge, die gespeichert werden kann pro Schlüssel beträgt 100 KB. Die angegebene Ablaufzeit ist nur ein Vorschlag. können zwischengespeicherte Daten werden vor diesem Zeitpunkt entfernt, wenn viele Daten im Cache gespeichert werden.

Die Obergrenze für im Cache gespeicherte Elemente beträgt 1.000. Werden mehr als 1.000 Elemente geschrieben, speichert der Cache am weitesten vom Ablaufdatum entfernt sind. Dieses Limit kann sich ändern.

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

Parameter

Name	Typ	Beschreibung
`key`	`String`	den Schlüssel zum Speichern des Werts unter
`value`	`String`	Wert, der im Cache gespeichert werden soll
`expirationInSeconds`	`Integer`	Maximale Zeit in Sekunden, die der Wert im Cache verbleibt. Die Die Mindestdauer beträgt 1 Sekunde und das Maximum 21.600 Sekunden (6 Stunden).

`putAll(values)`

Fügt dem Cache eine Reihe von Schlüssel/Wert-Paaren hinzu.

Ähnlich wie wiederholte Aufrufe von „put“, aber effizienter, da nur ein Aufruf an den Memcache-Server, um alle Werte festzulegen. Die maximale Länge eines Schlüssels beträgt 250 Zeichen. Das Maximum die pro Schlüssel gespeichert werden kann, beträgt 100 KB. Die Werte laufen aus dem Cache ab nach 600 Sekunden (10 Minuten)

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

Parameter

Name	Typ	Beschreibung
`values`	`Object`	Ein JavaScript-Objekt, das Stringschlüssel und -werte enthält.

Weitere Informationen

put(key, value)

`putAll(values, expirationInSeconds)`

Fügt dem Cache einen Satz von Schlüssel/Wert-Paaren mit einer Ablaufzeit (in Sekunden) hinzu.

Ähnlich wie wiederholte Aufrufe von „put“, aber effizienter, da nur ein Aufruf an den Memcache-Server, um alle Werte festzulegen. Die maximale Länge eines Schlüssels beträgt 250 Zeichen. Das Maximum die pro Schlüssel gespeichert werden kann, beträgt 100 KB. Die angegebene Ablaufzeit ist nur ein Vorschlag: im Cache gespeicherte Daten werden möglicherweise vorher entfernt, wenn viele Daten im Cache gespeichert werden.

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

Parameter

Name	Typ	Beschreibung
`values`	`Object`	Ein JavaScript-Objekt, das Stringschlüssel und -werte enthält
`expirationInSeconds`	`Integer`	Die maximale Zeit, die der Wert im Cache verbleibt, in Sekunden. Die Mindestablaufzeit beträgt 1 Sekunde und die maximal zulässige Ablaufzeit 21.600 Sekunden (6 Stunden) Die Standardablaufzeit beträgt 600 Sekunden (10 Minuten).

Weitere Informationen

put(key, value)

`remove(key)`

Entfernt einen Eintrag mit dem angegebenen Schlüssel aus dem Cache.

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

Parameter

Name	Typ	Beschreibung
`key`	`String`	den Schlüssel, der aus dem Cache entfernt werden soll

`removeAll(keys)`

Entfernt eine Reihe von Einträgen aus dem Cache.

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

Parameter

Name	Typ	Beschreibung
`keys`	`String[]`	Array der zu entfernenden Schlüssel