com.phloc.commons.cache

Class AbstractNotifyingCache<KEYTYPE,VALUETYPE>

java.lang.Object

com.phloc.commons.cache.AbstractCache<KEYTYPE,VALUETYPE>

com.phloc.commons.cache.AbstractNotifyingCache<KEYTYPE,VALUETYPE>

Type Parameters:

KEYTYPE - Cache key type

VALUETYPE - Cache value type

All Implemented Interfaces:

ISimpleCache<KEYTYPE,VALUETYPE>, SimpleCacheMBean, IHasSize, IHasName

Direct Known Subclasses:

AbstractNotifyingCacheWithMaxSize, DefaultSchemaCache, JAXBContextCache

@ThreadSafe
public abstract class AbstractNotifyingCache<KEYTYPE,VALUETYPE>
extends AbstractCache<KEYTYPE,VALUETYPE>

A caching class that has the ability to fill itself with the abstract getValueToCache(Object) method.

Author:

Philip Helger

Field Summary

Fields inherited from class com.phloc.commons.cache.AbstractCache

DEFAULT_JMX_ENABLED, m_aCacheAccessStats, m_aRWLock, STATISTICS_PREFIX

Constructor Summary

Constructors

Constructor and Description
AbstractNotifyingCache(String sCacheName)

Method Summary

Methods

Modifier and Type	Method and Description
VALUETYPE	getFromCache(KEYTYPE aKey) Get the cached value associated with the passed key.
protected abstract VALUETYPE	getValueToCache(KEYTYPE aKey) This abstract method is invoked, once a new value needs to be put into the cache.

Methods inherited from class com.phloc.commons.cache.AbstractCache

clearCache, createCache, getFromCacheNoStats, getFromCacheNoStatsNotLocked, getFromCacheNotLocked, getName, isEmpty, isJMXEnabled, isNotEmpty, putInCache, putInCacheNotLocked, removeFromCache, setJMXEnabled, size, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractNotifyingCache

public AbstractNotifyingCache(@Nonnull
                      String sCacheName)

Method Detail

getValueToCache

@Nonnull
@IsLocked(value=WRITE)
protected abstract VALUETYPE getValueToCache(KEYTYPE aKey)

This abstract method is invoked, once a new value needs to be put into the cache. This method is invoked within a locked section.

Parameters:

aKey - The key for which the value to cache is required. May be nullable or not - depends upon the implementation.

Returns:

The value to be cached. May not be null.

getFromCache

public final VALUETYPE getFromCache(KEYTYPE aKey)

Description copied from interface: ISimpleCache

Get the cached value associated with the passed key.

Specified by:

getFromCache in interface ISimpleCache<KEYTYPE,VALUETYPE>

Overrides:

getFromCache in class AbstractCache<KEYTYPE,VALUETYPE>

Parameters:

aKey - The key to be looked up. May be nullable or not - depends upon the implementation.

Returns:

null if no such value is in the cache.