Una referencia a una caché en particular.
Esta clase te permite insertar, recuperar y quitar elementos de una caché. Puede ser Esto es particularmente útil cuando deseas tener acceso frecuente a un recurso caro o lento. Por ejemplo: supongamos que tienes un feed RSS en example.com que tarda 20 segundos en recuperarse, pero quieres acelerar de 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á muy rápida hasta que el elemento caduque de la caché dentro de 25 minutos.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
get(key) | String | Obtiene el valor almacenado en caché para la clave dada o un valor nulo si no se encuentra ninguno. |
getAll(keys) | Object | Devuelve un objeto JavaScript que contiene todos los pares clave-valor encontrados en la caché para un array de claves. |
put(key, value) | void | Agrega un par clave-valor a la caché. |
put(key, value, expirationInSeconds) | void | Agrega un par clave-valor a la caché, con un tiempo de vencimiento (en segundos). |
putAll(values) | void | Agrega un conjunto de pares clave-valor a la caché. |
putAll(values, expirationInSeconds) | void | Agrega un conjunto de pares clave-valor a la caché, con un tiempo de vencimiento (en segundos). |
remove(key) | void | Quita una entrada de la caché usando la clave determinada. |
removeAll(keys) | void | Quita un conjunto de entradas de la caché. |
Documentación detallada
get(key)
Obtiene el valor almacenado en caché para la clave dada o un valor nulo si no se encuentra ninguno.
// Gets the value from the cache for the key 'foo'. var value = cache.get('foo');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
key | String | la clave para buscar en la caché |
Volver
String
: Es el valor almacenado en caché o nulo si no se encontró ninguno
getAll(keys)
Devuelve un objeto JavaScript que contiene todos los pares clave-valor encontrados en la caché para un array 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
Nombre | Tipo | Descripción |
---|---|---|
keys | String[] | las claves para buscar |
Volver
Object
: Es un objeto de JavaScript que contiene los pares clave-valor de todas las claves que se encuentran 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 artículos 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
Nombre | Tipo | Descripción |
---|---|---|
key | String | la clave para almacenar el valor en |
value | String | el valor que se almacenará en caché |
put(key, value, expirationInSeconds)
Agrega un par clave-valor a la caché, con un tiempo 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. La fecha y hora de vencimiento especificada es solo una sugerencia. los datos almacenados en caché pueden se quitará antes de este momento si se almacenan 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 artículos 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
Nombre | Tipo | Descripción |
---|---|---|
key | String | la clave para almacenar el valor en |
value | String | el valor que se almacenará en caché |
expirationInSeconds | Integer | El tiempo máximo que el valor permanece en la caché, en segundos. El el mínimo es de 1 segundo y el máximo es de 21,600 segundos (6 horas). |
putAll(values)
Agrega un conjunto de pares clave-valor a la caché.
Similar a las llamadas repetidas a “put”, pero más eficiente, ya que solo hace una llamada a Memcache para configurar todos los valores. La longitud máxima de una clave es de 250 caracteres. El máximo la cantidad 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 artículos 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
Nombre | Tipo | Descripción |
---|---|---|
values | Object | un objeto de JavaScript que contiene claves y valores de cadena |
Consulta también
putAll(values, expirationInSeconds)
Agrega un conjunto de pares clave-valor a la caché, con un tiempo de vencimiento (en segundos).
Similar a las llamadas repetidas a “put”, pero más eficiente, ya que solo hace una llamada a Memcache para configurar todos los valores. La longitud máxima de una clave es de 250 caracteres. El máximo la cantidad de datos que se pueden almacenar por clave es de 100 KB. La fecha y hora de vencimiento especificada es solo un sugerencia; Es posible que se quiten los datos almacenados en caché antes de este punto si se almacenan 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 artículos 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
Nombre | Tipo | Descripción |
---|---|---|
values | Object | Un objeto de JavaScript que contiene claves y valores de cadena |
expirationInSeconds | Integer | El tiempo máximo que el valor permanece en la caché, en segundos. el vencimiento mínimo permitido es de 1 segundo y el vencimiento máximo permitido es de 21, 600 segundos (6 horas). El vencimiento predeterminado es 600 segundos (10 minutos). |
Consulta también
remove(key)
Quita una entrada de la caché usando la clave determinada.
// Removes any cache entries for 'foo' cache.remove('foo');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
key | String | la clave que se quitará 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
Nombre | Tipo | Descripción |
---|---|---|
keys | String[] | el array de claves para quitar |