Class Cache

Caché

Es una referencia a una caché en particular.

Esta clase te permite insertar, recuperar y quitar elementos de una caché. Esto puede ser particularmente útil cuando deseas acceder con frecuencia a un recurso costoso o lento. Por ejemplo, supongamos que tienes un feed RSS en example.com que tarda 20 segundos en recuperarse, pero quieres acelerar el acceso en una solicitud promedio.

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;
}
Deberás esperar 20 segundos si el elemento no está en la caché, pero las llamadas posteriores serán muy rápidas hasta que el elemento venza en 25 minutos.

Métodos

MétodoTipo de datos que se muestraDescripción breve
get(key)StringObtiene el valor almacenado en caché para la clave dada o nulo si no se encuentra ninguno.
getAll(keys)ObjectMuestra un objeto de JavaScript que contiene todos los pares clave-valor encontrados en la caché para un arreglo de claves.
put(key, value)voidAgrega un par clave-valor a la caché.
put(key, value, expirationInSeconds)voidAgrega un par clave-valor a la caché, con una fecha de vencimiento (en segundos).
putAll(values)voidAgrega un conjunto de pares clave-valor a la caché.
putAll(values, expirationInSeconds)voidAgrega un conjunto de pares clave-valor a la caché, con una fecha de vencimiento (en segundos).
remove(key)voidQuita una entrada de la caché con la clave proporcionada.
removeAll(keys)voidQuita un conjunto de entradas de la caché.

Documentación detallada

get(key)

Obtiene el valor almacenado en caché para la clave dada o nulo si no se encuentra ninguno.

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

Parámetros

NombreTipoDescripción
keyStringla clave para buscar en la caché

Devolvedor

String: El valor almacenado en caché, o nulo si no se encontró ninguno


getAll(keys)

Muestra un objeto de JavaScript que contiene todos los pares clave-valor encontrados en la caché para un arreglo de claves.

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

Parámetros

NombreTipoDescripción
keysString[]las claves para buscar

Devolvedor

Object: Es un objeto de JavaScript que contiene los pares clave-valor para todas las claves encontradas en la caché.

Consulta también


put(key, value)

Agrega un par clave-valor a la caché.

La longitud máxima de una clave es de 250 caracteres. La cantidad máxima de datos que se pueden almacenar por clave es de 100 KB. El valor vencerá de la caché después de 600 segundos (10 minutos).

El límite para los elementos almacenados en caché es de 1,000. Si se escriben más de 1,000 elementos, la caché almacena los 900 elementos que están más lejos del vencimiento. Este límite puede cambiar.

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

Parámetros

NombreTipoDescripción
keyStringla clave para almacenar el valor en
valueStringel valor que se almacenará en caché

put(key, value, expirationInSeconds)

Agrega un par clave-valor a la caché, con una fecha de vencimiento (en segundos).

La longitud máxima de una clave es de 250 caracteres. La cantidad máxima de datos que se pueden almacenar por clave es de 100 KB. El tiempo de vencimiento especificado es solo una sugerencia; los datos almacenados en caché se pueden quitar antes de este momento si hay muchos datos en caché.

El límite para los elementos almacenados en caché es de 1,000. Si se escriben más de 1,000 elementos, la caché almacena los 900 elementos que están más lejos del vencimiento. Este límite puede cambiar.

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

Parámetros

NombreTipoDescripción
keyStringla clave para almacenar el valor en
valueStringel valor que se almacenará en caché
expirationInSecondsIntegerel tiempo máximo que el valor permanece en la caché, en segundos. El mínimo es 1 segundo y el máximo es 21,600 segundos (6 horas).

putAll(values)

Agrega un conjunto de pares clave-valor a la caché.

Es similar a las llamadas repetidas a “put”, pero es más eficiente, ya que solo realiza una llamada al servidor de Memcache para establecer todos los valores. La longitud máxima de una clave es de 250 caracteres. La cantidad máxima de datos que se pueden almacenar por clave es de 100 KB. Los valores vencerán de la caché después de 600 segundos (10 minutos).

El límite para los elementos almacenados en caché es de 1,000. Si se escriben más de 1,000 elementos, la caché almacena los 900 elementos que están más lejos del vencimiento. Este límite puede cambiar.

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

Parámetros

NombreTipoDescripción
valuesObjectun objeto de JavaScript que contiene claves y valores de string

Consulta también


putAll(values, expirationInSeconds)

Agrega un conjunto de pares clave-valor a la caché, con una fecha de vencimiento (en segundos).

Es similar a las llamadas repetidas a “put”, pero es más eficiente, ya que solo realiza una llamada al servidor de Memcache para establecer todos los valores. La longitud máxima de una clave es de 250 caracteres. La cantidad máxima de datos que se pueden almacenar por clave es de 100 KB. El tiempo de vencimiento especificado es solo una sugerencia; los datos almacenados en caché pueden quitarse antes de esta fecha si muchos datos están almacenados en caché.

El límite para los elementos almacenados en caché es de 1,000. Si se escriben más de 1,000 elementos, la caché almacena los 900 elementos que están más lejos del vencimiento. Este límite puede cambiar.

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

Parámetros

NombreTipoDescripción
valuesObjectUn objeto de JavaScript que contiene claves y valores de string
expirationInSecondsIntegerEl tiempo máximo que el valor permanece en la caché, en segundos. El vencimiento mínimo permitido es 1 segundo y el vencimiento máximo permitido es 21, 600 segundos (6 horas). El vencimiento predeterminado es de 600 segundos (10 minutos).

Consulta también


remove(key)

Quita una entrada de la caché con la clave proporcionada.

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

Parámetros

NombreTipoDescripción
keyStringla clave para quitarla de la caché

removeAll(keys)

Quita un conjunto de entradas de la caché.

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

Parámetros

NombreTipoDescripción
keysString[]la matriz de claves para quitar