Uma referência a um cache específico.
Essa classe permite inserir, recuperar e remover itens de um cache. Isso pode ser especialmente útil quando se quer acesso frequente a um recurso caro ou lento. Por exemplo: Digamos que você tenha um feed RSS em example.com que leva 20 segundos para buscar, mas você quer acelerar acesso em uma solicitação comum.
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; }
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
get(key) | String | Recebe o valor armazenado em cache para a chave especificada ou nulo se nenhum for encontrado. |
getAll(keys) | Object | Retorna um objeto JavaScript que contém todos os pares de chave/valor encontrados no cache para uma matriz de chaves. |
put(key, value) | void | Adiciona um par de chave-valor ao cache. |
put(key, value, expirationInSeconds) | void | Adiciona um par de chave-valor ao cache, com um prazo de validade (em segundos). |
putAll(values) | void | Adiciona um conjunto de pares de chave-valor ao cache. |
putAll(values, expirationInSeconds) | void | Adiciona um conjunto de pares de chave-valor ao cache, com um prazo de validade (em segundos). |
remove(key) | void | Remove uma entrada do cache usando a chave fornecida. |
removeAll(keys) | void | Remove um conjunto de entradas do cache. |
Documentação detalhada
get(key)
Recebe o valor armazenado em cache para a chave especificada ou nulo se nenhum for encontrado.
// Gets the value from the cache for the key 'foo'. var value = cache.get('foo');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
key | String | a chave a ser procurada no cache |
Retornar
String
: o valor em cache, ou nulo se nenhum for encontrado.
getAll(keys)
Retorna um objeto JavaScript que contém todos os pares de chave/valor encontrados no cache para uma matriz de chaves.
// 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
Nome | Tipo | Descrição |
---|---|---|
keys | String[] | as chaves para pesquisar |
Retornar
Object
: um objeto JavaScript que contém os pares de chave-valor para todas as chaves encontradas no cache
Consulte também
put(key, value)
Adiciona um par de chave-valor ao cache.
O comprimento máximo de uma chave é de 250 caracteres. A quantidade máxima de dados que pode ser armazenada por chave é de 100 KB. O valor vai expirar no cache após 600 segundos (10 minutos).
O limite de itens em cache é de 1.000. Se mais de 1.000 itens forem gravados, o cache armazenará os 900 itens mais distantes da expiração. Esse limite pode mudar.
// Puts the value 'bar' into the cache using the key 'foo' cache.put('foo', 'bar');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
key | String | a chave para armazenar o valor |
value | String | o valor a ser armazenado em cache |
put(key, value, expirationInSeconds)
Adiciona um par de chave-valor ao cache, com um prazo de validade (em segundos).
O comprimento máximo de uma chave é de 250 caracteres. A quantidade máxima de dados que pode ser armazenada por chave é de 100 KB. O prazo de validade especificado é apenas uma sugestão. os dados em cache podem ser sejam removidos antes desse período se muitos dados estiverem armazenados em cache.
O limite de itens em cache é de 1.000. Se mais de 1.000 itens forem gravados, o cache armazenará os 900 itens mais distantes da expiração. Esse limite pode mudar.
// 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
Nome | Tipo | Descrição |
---|---|---|
key | String | a chave para armazenar o valor |
value | String | o valor a ser armazenado em cache |
expirationInSeconds | Integer | o tempo máximo que o valor permanece no cache, em segundos. A o mínimo é 1 segundo e o máximo é 21.600 segundos (6 horas). |
putAll(values)
Adiciona um conjunto de pares de chave-valor ao cache.
Semelhante às chamadas repetidas para "put", mas mais eficiente, pois faz apenas uma chamada para o servidor Memcache para definir todos os valores. O comprimento máximo de uma chave é de 250 caracteres. O máximo de dados que pode ser armazenado por chave é 100 KB. Os valores expiram do cache após 600 segundos (10 minutos).
O limite de itens em cache é de 1.000. Se mais de 1.000 itens forem gravados, o cache armazenará os 900 itens mais distantes da expiração. Esse limite pode mudar.
// 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
Nome | Tipo | Descrição |
---|---|---|
values | Object | um objeto JavaScript contendo chaves e valores de string |
Consulte também
putAll(values, expirationInSeconds)
Adiciona um conjunto de pares de chave-valor ao cache, com um prazo de validade (em segundos).
Semelhante às chamadas repetidas para "put", mas mais eficiente, pois faz apenas uma chamada para o servidor Memcache para definir todos os valores. O comprimento máximo de uma chave é de 250 caracteres. O máximo de dados que pode ser armazenado por chave é 100 KB. O prazo de validade especificado é apenas um sugestão; dados em cache podem ser removidos antes desse período se muitos dados estiverem armazenados em cache.
O limite de itens em cache é de 1.000. Se mais de 1.000 itens forem gravados, o cache armazenará os 900 itens mais distantes da expiração. Esse limite pode mudar.
// 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
Nome | Tipo | Descrição |
---|---|---|
values | Object | Objeto JavaScript que contém chaves e valores de string |
expirationInSeconds | Integer | O tempo máximo que o valor permanece no cache, em segundos. O a expiração mínima permitida é de 1 segundo, e a expiração máxima permitida é 21.600 segundos (6 horas). A expiração padrão é de 600 segundos (10 minutos). |
Consulte também
remove(key)
Remove uma entrada do cache usando a chave fornecida.
// Removes any cache entries for 'foo' cache.remove('foo');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
key | String | a chave a ser removida do cache |
removeAll(keys)
Remove um conjunto de entradas do cache.
// Removes entries from the cache with keys 'foo' and 'x' cache.removeAll(['foo', 'x']);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
keys | String[] | a matriz de chaves a serem removidas |