org.pentaho.platform.plugin.services.cache

Class CacheManager

java.lang.Object

org.pentaho.platform.plugin.services.cache.CacheManager

All Implemented Interfaces:

ICacheManager, ILogoutListener

public class CacheManager
extends Object
implements ICacheManager

This class provides an access point for pluggable caching mechanisms. Right now, it only supports the caching mechanisms implemented in org.hibernate.cache.

To use the cache manager, you need to include the following information in your pentaho.xml.

 
  <cache-provider>
    <class>org.hibernate.cache.xxxxxxxx</class>
    <region>pentahoCache</region>
    <properties>
      <property name="someProperty">someValue</property>
    </properties>
  </cache-provider>
 

The specified class must implement the org.hibernate.cache.CacheProvider interface.

Each implementation of the org.hibernate.cache.CacheProvider has slightly different requirements with respect to the required input parameters - so, please see the classes in that package for more information (available from the Sourceforge Hibernate project). Also, some cache providers (notably the org.hibernate.cache.EhCacheProvider) completely ignore the passed in properties, and only configure themselves by locating a configuration file (e.g. ehcache.xml) on the classpath.

The cache manager supports session-based caching (that is, caching of data that is user-specific) as well as global-based caching (that is, caching of data that is system-wide). To differentiate between session-based and global-based caching, there are different methods that get called depending upon the storage type.

Data that is cached for user sessions require an IPentahoSession object to be passed in. The cache manager uses the IPentahoSession.getId() to classify saved objects underneath a specific user session. No information is actually stored in the user session object. For an example of this, see
putInSessionCache(IPentahoSession session, String key, Object value)

Data that is server-wide (i.e. global) uses different methods for storage/retrieval/management. For an example of this, see
getFromGlobalCache(Object key)

Example Usage:

 String globalCachable = "String to cache";
 String globalCacheKey = "StringKey";
 CacheManager cacheManager = PentahoSystem.getCacheManager();
 cacheManager.putInGlobalCache( globalCacheKey, globalCachable );
 

Important Considerations

• Most caches require objects that go into the cache as well as their respective object key implement Serializable. It is a safe assumption that both the Key and the Value should implement Serializable.
• Some caches are read-only. Other caches are read-write. What does this mean? It means that once you put an object in the cache, you can't put an object into the cache with the same key. You'd need to remove it first

Author:

mbatchel

See Also:

CacheProvider, Cache

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.apache.commons.logging.Log	logger

Fields inherited from interface org.pentaho.platform.api.engine.ICacheManager

GLOBAL, SESSION

Constructor Summary

Constructors

Constructor and Description
CacheManager() The constructor performs the following tasks:

Method Summary

Modifier and Type	Method and Description
boolean	addCacheRegion(String region)
boolean	addCacheRegion(String region, Properties cacheProperties)
boolean	cacheEnabled()
boolean	cacheEnabled(String region)
void	cacheStop()
void	clearCache()
void	clearRegionCache(String region)
Set	getAllEntriesFromRegionCache(String region)
Set	getAllKeysFromRegionCache(String region)
List	getAllValuesFromRegionCache(String region)
protected org.hibernate.cache.CacheProvider	getCacheProvider() Returns the underlying cache provider (implements org.hibernate.cache.CacheProvider
long	getElementCountInGlobalCache()
long	getElementCountInRegionCache(String region)
long	getElementCountInSessionCache()
Object	getFromGlobalCache(Object key)
Object	getFromRegionCache(String region, Object key)
Object	getFromSessionCache(IPentahoSession session, String key)
void	killSessionCache(IPentahoSession session)
void	killSessionCaches()
void	onLogout(IPentahoSession session)
void	putInGlobalCache(Object key, Object value)
void	putInRegionCache(String region, Object key, Object value)
void	putInSessionCache(IPentahoSession session, String key, Object value)
void	removeFromGlobalCache(Object key)
void	removeFromRegionCache(String region, Object key)
void	removeFromSessionCache(IPentahoSession session, String key)
void	removeRegionCache(String region)
protected void	setupCacheProvider(Properties cacheProperties)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logger

protected static final org.apache.commons.logging.Log logger

Constructor Detail

CacheManager

public CacheManager()

The constructor performs the following tasks:

• Gets the Pentaho System Settings
• Reads the cache-provider/class element.
• Reads the cache-provider/region element.
• Reads in any properties under cache-provider/properties/*
• Attempts to instance the cache provider classes specified
• Starts the cache (see the org.hibernate.cache.CacheProvider interface)
• Calls the buildCache method (see the org.hibernate.cache.CacheProvider interface)

Method Detail

setupCacheProvider

protected void setupCacheProvider(Properties cacheProperties)

cacheStop

public void cacheStop()

Specified by:

cacheStop in interface ICacheManager

getCacheProvider

protected org.hibernate.cache.CacheProvider getCacheProvider()

Returns the underlying cache provider (implements org.hibernate.cache.CacheProvider

Returns:

cacheProvider.

cacheEnabled

public boolean cacheEnabled(String region)

Specified by:

cacheEnabled in interface ICacheManager

onLogout

public void onLogout(IPentahoSession session)

Specified by:

onLogout in interface ICacheManager

Specified by:

onLogout in interface ILogoutListener

addCacheRegion

public boolean addCacheRegion(String region,
                              Properties cacheProperties)

Specified by:

addCacheRegion in interface ICacheManager

addCacheRegion

public boolean addCacheRegion(String region)

Specified by:

addCacheRegion in interface ICacheManager

clearRegionCache

public void clearRegionCache(String region)

Specified by:

clearRegionCache in interface ICacheManager

removeRegionCache

public void removeRegionCache(String region)

Specified by:

removeRegionCache in interface ICacheManager

putInRegionCache

public void putInRegionCache(String region,
                             Object key,
                             Object value)

Specified by:

putInRegionCache in interface ICacheManager

getFromRegionCache

public Object getFromRegionCache(String region,
                                 Object key)

Specified by:

getFromRegionCache in interface ICacheManager

getAllValuesFromRegionCache

public List getAllValuesFromRegionCache(String region)

Specified by:

getAllValuesFromRegionCache in interface ICacheManager

getAllKeysFromRegionCache

public Set getAllKeysFromRegionCache(String region)

Specified by:

getAllKeysFromRegionCache in interface ICacheManager

getAllEntriesFromRegionCache

public Set getAllEntriesFromRegionCache(String region)

Specified by:

getAllEntriesFromRegionCache in interface ICacheManager

removeFromRegionCache

public void removeFromRegionCache(String region,
                                  Object key)

Specified by:

removeFromRegionCache in interface ICacheManager

cacheEnabled

public boolean cacheEnabled()

Specified by:

cacheEnabled in interface ICacheManager

clearCache

public void clearCache()

Specified by:

clearCache in interface ICacheManager

getFromGlobalCache

public Object getFromGlobalCache(Object key)

Specified by:

getFromGlobalCache in interface ICacheManager

getFromSessionCache

public Object getFromSessionCache(IPentahoSession session,
                                  String key)

Specified by:

getFromSessionCache in interface ICacheManager

killSessionCache

public void killSessionCache(IPentahoSession session)

Specified by:

killSessionCache in interface ICacheManager

killSessionCaches

public void killSessionCaches()

Specified by:

killSessionCaches in interface ICacheManager

putInGlobalCache

public void putInGlobalCache(Object key,
                             Object value)

Specified by:

putInGlobalCache in interface ICacheManager

putInSessionCache

public void putInSessionCache(IPentahoSession session,
                              String key,
                              Object value)

Specified by:

putInSessionCache in interface ICacheManager

removeFromGlobalCache

public void removeFromGlobalCache(Object key)

Specified by:

removeFromGlobalCache in interface ICacheManager

removeFromSessionCache

public void removeFromSessionCache(IPentahoSession session,
                                   String key)

Specified by:

removeFromSessionCache in interface ICacheManager

getElementCountInRegionCache

public long getElementCountInRegionCache(String region)

Specified by:

getElementCountInRegionCache in interface ICacheManager

getElementCountInSessionCache

public long getElementCountInSessionCache()

Specified by:

getElementCountInSessionCache in interface ICacheManager

getElementCountInGlobalCache

public long getElementCountInGlobalCache()

Specified by:

getElementCountInGlobalCache in interface ICacheManager