Cached: cachovací aspekt pro Kdyby\Aop

Cached je aspekt pro Kdyby\Aop, který se postará o cachování návratových hodnot ve vaších servisách.

Použití je následující:

class MyService {

	/**
	 * @Cached\Cached
	 */
	public function getNumber() {
		return rand(1, 1000);
	}

}

Po prvním zavolání metody se návratová hodnota uloží do cache a při dalším volání se bez vykonání původní metody vrátí nacacheovaná hodnota.

Pozn.: kvůli malému bugu v Kdyby\Aop nelze v současné době importovat anotaci s pomocí use statementu (proto to ošklivé @Cached\Cached).

Instalace

Rozšíření potřebuje nainstalované Kdyby\Aop.

Nainstalujte Cached pomocí composeru:

composer require redhead/cached:@dev

A zaregistrujte extension. V Nette 2.1 takto:

extensions:
	cached: Cached\CachedExtension

Nakonec je nutné zaregistrovat samotný aspekt (pracuje se na tom, aby toto nebylo nutné):

aspects:
	- Cached\CachingAspect

A můžete začít cacheovat!

Možnosti nastavení

Samozřejmostí je i možnost nastavovat cachovaní – namespace, klíče a možnosti cachování z Nette\Caching\Cache. Způsoby nastavení jsou možné:

1. přímo v anotaci

/**
 * @Cached\Cached(expire="1 hour", sliding=true, key="myKey", tags=["tag1"])
 */

2. v profilu v konfiguraci

cached:
	profiles:
		myProfile:
			sliding: true
			expire: 1 hour
			tags: [tag1]

a specifikováním jména profilu v anotaci:

/**
 * @Cached\Cached(profile="myProfile")
 */

nebo pokud se neuvede anotační property profile, použije se profil jménem default. Nastavení z profilu lze přebít/doplnit anotačními propertami.

Další možnosti najdete v dokumentaci.

Enjoy a posílejte nápady, kritiku, pull requesty, atd! :)

Editoval redhead (17. 9. 2013 21:30)