org.jsecurity.cache
Interface CacheManager

All Known Implementing Classes:

EhCacheManager, HashtableCacheManager

public interface CacheManager

A CacheManager provides and maintains the lifecycles of Cache instances.

JSecurity doesn't implement a full Cache mechanism itself, since that is outside the core competency of a Security framework. Instead, this interface provides an abstraction (wrapper) API on top of an underlying cache framework's main Manager component (e.g. JCache, Ehcache, JCS, OSCache, JBossCache, TerraCotta, Coherence, GigaSpaces, etc, etc), allowing a JSecurity user to configure any cache mechanism they choose.

Since:

0.9

Author:

Les Hazlewood

Method Summary

Cache

getCache(String name) Acquires the cache with the specified name.

Method Detail

getCache

Cache getCache(String name)
               throws CacheException

Acquires the cache with the specified name. If a cache does not yet exist with that name, a new one will be created with that name and returned.

Parameters:

name - the name of the cache to acquire.

Returns:

the Cache with the given name

Throws:

CacheException - if there is an error acquiring the Cache instance.