# Guardar valores em cache na memória

> Guarde valores com CACHE.set() e uma expiração, leia-os com CACHE.get() e apague-os com remove() ou reset().

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: pt
Content-SHA256: b6d7786c34f34c46316c73074bd4e33a6bcc55c8addeb6ffb6e8cdd9a8015b5b
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`CACHE` é um armazém chave-valor em memória com expiração. `CACHE.set(key, value, expire)` guarda um valor (a expiração é um texto como `'10 seconds'` ou `'5 minutes'`, por omissão `'5 minutes'`). `CACHE.get(key, default)` devolve o valor, ou o valor por omissão depois de expirar. `CACHE.remove(key)` apaga uma chave e `CACHE.reset(search)` apaga todas as chaves que contêm o texto.

Use-o para resultados caros de calcular que podem estar um pouco desatualizados. A cache vive no processo: é limpa no reinício e não é partilhada entre processos.

```js controllers/cache.js
exports.install = function() {
	ROUTE('GET /slow/', slow);
	ROUTE('DELETE /slow/', clear);
};

var computed = 0;

function slow($) {

	var cached = CACHE.get('slow-result');

	if (cached) {
		$.json({ value: cached, cached: true, computed: computed });
		return;
	}

	computed++;
	var value = 'result-' + computed;
	CACHE.set('slow-result', value, '1 second');
	$.json({ value: value, cached: false, computed: computed });
}

function clear($) {
	CACHE.remove('slow-result');
	$.json({ ok: true });
}
```