Class Cache

Cache

Référence à un cache particulier.

Cette classe vous permet d'insérer, de récupérer et de supprimer des éléments d'un cache. Il peut s'agir particulièrement utile lorsque vous souhaitez accéder fréquemment à une ressource coûteuse ou lente. Par exemple : Imaginons que vous avez un flux RSS sur example.com dont l'extraction prend 20 secondes, mais que vous voulez accélérer l'accès pour une demande moyenne.

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;
}
Vous devrez quand même attendre les 20 secondes si l'élément ne se trouve pas dans le cache, mais les appels suivants est très rapide jusqu'à ce que l'élément expire du cache au bout de 25 minutes.

Méthodes

MéthodeType renvoyéBrève description
get(key)StringRécupère la valeur mise en cache pour la clé donnée, ou la valeur "null" si aucune clé n'est trouvée.
getAll(keys)ObjectRenvoie un objet JavaScript contenant toutes les paires clé/valeur trouvées dans le cache pour un tableau de clés.
put(key, value)voidAjoute une paire clé/valeur au cache.
put(key, value, expirationInSeconds)voidAjoute une paire clé/valeur au cache, avec un délai d'expiration (en secondes).
putAll(values)voidAjoute un ensemble de paires clé/valeur au cache.
putAll(values, expirationInSeconds)voidAjoute un ensemble de paires clé/valeur au cache, avec un délai d'expiration (en secondes).
remove(key)voidSupprime une entrée du cache à l'aide de la clé donnée.
removeAll(keys)voidSupprime un ensemble d'entrées du cache.

Documentation détaillée

get(key)

Récupère la valeur mise en cache pour la clé donnée, ou la valeur "null" si aucune clé n'est trouvée.

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

Paramètres

NomTypeDescription
keyStringla clé à rechercher dans le cache ;

Renvois

String : valeur mise en cache ou valeur "null" si aucune n'a été trouvée


getAll(keys)

Renvoie un objet JavaScript contenant toutes les paires clé/valeur trouvées dans le cache pour un tableau de clés.

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

Paramètres

NomTypeDescription
keysString[]clés pour rechercher

Renvois

Object : objet JavaScript contenant les paires clé/valeur pour toutes les clés trouvées dans le cache.

Voir aussi


put(key, value)

Ajoute une paire clé/valeur au cache.

La longueur maximale d'une clé est de 250 caractères. La quantité maximale de données pouvant être stockées par clé est de 100 Ko. La valeur expire du cache au bout de 600 secondes (10 minutes).

Le nombre maximal d'éléments mis en cache est de 1 000. Si plus de 1 000 éléments sont écrits, le cache stocke les 900 articles dont la date d'expiration est la plus éloignée. Cette limite est susceptible d'être modifiée.

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

Paramètres

NomTypeDescription
keyStringla clé pour stocker la valeur sous
valueStringla valeur à mettre en cache

put(key, value, expirationInSeconds)

Ajoute une paire clé/valeur au cache, avec un délai d'expiration (en secondes).

La longueur maximale d'une clé est de 250 caractères. La quantité maximale de données pouvant être stockées par clé est de 100 Ko. Le délai d'expiration spécifié n'est qu'une suggestion. les données mises en cache peuvent être supprimées avant cette date si de nombreuses données sont mises en cache.

Le nombre maximal d'éléments mis en cache est de 1 000. Si plus de 1 000 éléments sont écrits, le cache stocke les 900 articles dont la date d'expiration est la plus éloignée. Cette limite est susceptible d'être modifiée.

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

Paramètres

NomTypeDescription
keyStringla clé pour stocker la valeur sous
valueStringla valeur à mettre en cache
expirationInSecondsIntegerDurée maximale, en secondes, de la valeur dans le cache. La la valeur minimale est de 1 seconde et la valeur maximale de 21 600 secondes (6 heures).

putAll(values)

Ajoute un ensemble de paires clé/valeur au cache.

Semblable aux appels répétés de la méthode "put", mais plus efficace, car elle n'effectue qu'un seul appel à la méthode Memcache pour définir toutes les valeurs. La longueur maximale d'une clé est de 250 caractères. La valeur la quantité de données pouvant être stockée par clé est de 100 Ko. Les valeurs expireront du cache après 600 secondes (10 minutes)

Le nombre maximal d'éléments mis en cache est de 1 000. Si plus de 1 000 éléments sont écrits, le cache stocke les 900 articles dont la date d'expiration est la plus éloignée. Cette limite est susceptible d'être modifiée.

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

Paramètres

NomTypeDescription
valuesObjectun objet JavaScript contenant des clés et des valeurs de chaîne

Voir aussi


putAll(values, expirationInSeconds)

Ajoute un ensemble de paires clé/valeur au cache, avec un délai d'expiration (en secondes).

Semblable aux appels répétés de la méthode "put", mais plus efficace, car elle n'effectue qu'un seul appel à la méthode Memcache pour définir toutes les valeurs. La longueur maximale d'une clé est de 250 caractères. La valeur la quantité de données pouvant être stockée par clé est de 100 Ko. Le délai d'expiration spécifié n'est qu'un suggestion; les données mises en cache peuvent être supprimées avant cette date si un grand nombre de données sont mises en cache.

Le nombre maximal d'éléments mis en cache est de 1 000. Si plus de 1 000 éléments sont écrits, le cache stocke les 900 articles dont la date d'expiration est la plus éloignée. Cette limite est susceptible d'être modifiée.

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

Paramètres

NomTypeDescription
valuesObjectUn objet JavaScript contenant des clés et des valeurs de chaîne
expirationInSecondsIntegerDurée maximale de conservation d'une valeur dans le cache, en secondes. La valeur d'expiration minimale autorisée est de 1 seconde, et la valeur d'expiration maximale autorisée est de 21 600 secondes (6 heures) Le délai d'expiration par défaut est de 600 secondes (10 minutes).

Voir aussi


remove(key)

Supprime une entrée du cache à l'aide de la clé donnée.

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

Paramètres

NomTypeDescription
keyStringla clé à supprimer du cache

removeAll(keys)

Supprime un ensemble d'entrées du cache.

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

Paramètres

NomTypeDescription
keysString[]le tableau de clés à supprimer