net.sf.ehcache.statistics.sampled
Class SampledCacheStatisticsWrapper

java.lang.Object
  net.sf.ehcache.statistics.sampled.SampledCacheStatisticsWrapper

All Implemented Interfaces:

CacheUsageListener, SampledCacheStatistics

public class SampledCacheStatisticsWrapper
extends java.lang.Object
implements CacheUsageListener, SampledCacheStatistics

An implementation of SampledCacheStatistics and also implements CacheUsageListener and depends on the notification received from these to update the stats. Uses separate delegates depending on whether sampled statistics is enabled or not.

To collect statistics data, instances of this class should be registered as a CacheUsageListener to a Cache

Since:

1.7

Author:

Abhishek Sanoujam

Constructor Summary

SampledCacheStatisticsWrapper()
Default constructor.

Method Summary

void	clearStatistics() Clears sampled statistics for this cache
void	disableSampledStatistics() Disable sampled statistics collection
void	dispose() Called to dispose off the listener
void	enableSampledStatistics(FailSafeTimer timer) Enable sampled statistics collection
long	getAverageGetTimeMostRecentSample() Get most recent value for average time taken for get() operation in the cache
long	getCacheElementEvictedMostRecentSample() Get most recent value element evicted from cache
long	getCacheElementExpiredMostRecentSample() Get most recent value element expired from cache
long	getCacheElementPutMostRecentSample() Get most recent value element puts in the cache
long	getCacheElementRemovedMostRecentSample() Get most recent value element removed from cache
long	getCacheElementUpdatedMostRecentSample() Get most recent value element updates , i.e.
long	getCacheHitInMemoryMostRecentSample() Get most recent value for in-memory cache hit
long	getCacheHitMostRecentSample() Get most recent value for cache hit
long	getCacheHitOnDiskMostRecentSample() Get most recent value for on-disk cache hit
long	getCacheMissExpiredMostRecentSample() Get most recent value for cache miss as result of the element getting expired
long	getCacheMissMostRecentSample() Get most recent value for cache miss
long	getCacheMissNotFoundMostRecentSample() Get most recent value for cache miss as result of the element not found in cache
int	getStatisticsAccuracy() Get value for statisticsAccuracy
java.lang.String	getStatisticsAccuracyDescription() Get Description for statisticsAccuracy
boolean	isSampledStatisticsEnabled() Returns true if statistics collection is enabled for cache, otherwise false
void	notifyCacheElementEvicted() Called when an element is expired in the cache
void	notifyCacheElementExpired() Called when an element in the cache expires
void	notifyCacheElementPut() Called when an element is inserted in the cache
void	notifyCacheElementRemoved() Called when an element is removed from the cache
void	notifyCacheElementUpdated() Called when an element is updated in the cache, i.e.
void	notifyCacheHitInMemory() Called on a cache hit in the MemoryStore
void	notifyCacheHitOnDisk() Called on a cache hit in the DiskStore
void	notifyCacheMissedWithExpired() Called when an element is found in the cache but already expired
void	notifyCacheMissedWithNotFound() Called when an element is not found in the cache
void	notifyRemoveAll() Called when Cache.removeAll() is called
void	notifyStatisticsAccuracyChanged(int statisticsAccuracy) Notified when the statistics accuracy is changed.
void	notifyStatisticsCleared() Called when statistics is cleared
void	notifyStatisticsEnabledChanged(boolean enableStatistics) Called when statistics is enabled/disabled
void	notifyTimeTakenForGet(long millis) Notified with time taken for a get operation in the cache

Methods inherited from class java.lang.Object

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

Constructor Detail

SampledCacheStatisticsWrapper

public SampledCacheStatisticsWrapper()

Default constructor.

Method Detail

enableSampledStatistics

public void enableSampledStatistics(FailSafeTimer timer)

Enable sampled statistics collection

Parameters:

timer -

disableSampledStatistics

public void disableSampledStatistics()

Disable sampled statistics collection

isSampledStatisticsEnabled

public boolean isSampledStatisticsEnabled()

Returns true if statistics collection is enabled for cache, otherwise false

Specified by:

isSampledStatisticsEnabled in interface SampledCacheStatistics

Returns:

true if sampled statistics is enabled, false otherwise

dispose

public void dispose()

Called to dispose off the listener

Specified by:

dispose in interface CacheUsageListener

Specified by:

dispose in interface SampledCacheStatistics

getAverageGetTimeMostRecentSample

public long getAverageGetTimeMostRecentSample()

Get most recent value for average time taken for get() operation in the cache

Specified by:

getAverageGetTimeMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample of average get time taken for a get operation

getCacheElementEvictedMostRecentSample

public long getCacheElementEvictedMostRecentSample()

Get most recent value element evicted from cache

Specified by:

getCacheElementEvictedMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for element evicted count

getCacheElementExpiredMostRecentSample

public long getCacheElementExpiredMostRecentSample()

Get most recent value element expired from cache

Specified by:

getCacheElementExpiredMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent value for element expired count

getCacheElementPutMostRecentSample

public long getCacheElementPutMostRecentSample()

Get most recent value element puts in the cache

Specified by:

getCacheElementPutMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for number of element puts

getCacheElementRemovedMostRecentSample

public long getCacheElementRemovedMostRecentSample()

Get most recent value element removed from cache

Specified by:

getCacheElementRemovedMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for element removed count

getCacheElementUpdatedMostRecentSample

public long getCacheElementUpdatedMostRecentSample()

Get most recent value element updates , i.e. put() on elements with already existing keys in the cache

Specified by:

getCacheElementUpdatedMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sampled value for element update count

getCacheHitInMemoryMostRecentSample

public long getCacheHitInMemoryMostRecentSample()

Get most recent value for in-memory cache hit

Specified by:

getCacheHitInMemoryMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache hit count in memory

getCacheHitMostRecentSample

public long getCacheHitMostRecentSample()

Get most recent value for cache hit

Specified by:

getCacheHitMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache hit count

getCacheHitOnDiskMostRecentSample

public long getCacheHitOnDiskMostRecentSample()

Get most recent value for on-disk cache hit

Specified by:

getCacheHitOnDiskMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache hit count on disk

getCacheMissExpiredMostRecentSample

public long getCacheMissExpiredMostRecentSample()

Get most recent value for cache miss as result of the element getting expired

Specified by:

getCacheMissExpiredMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss count and the reason for miss being the element got expired

getCacheMissMostRecentSample

public long getCacheMissMostRecentSample()

Get most recent value for cache miss

Specified by:

getCacheMissMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss count

getCacheMissNotFoundMostRecentSample

public long getCacheMissNotFoundMostRecentSample()

Get most recent value for cache miss as result of the element not found in cache

Specified by:

getCacheMissNotFoundMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss not found count

getStatisticsAccuracy

public int getStatisticsAccuracy()

Get value for statisticsAccuracy

Specified by:

getStatisticsAccuracy in interface SampledCacheStatistics

Returns:

one of Statistics#STATISTICS_ACCURACY_BEST_EFFORT, Statistics#STATISTICS_ACCURACY_GUARANTEED, Statistics#STATISTICS_ACCURACY_NONE

clearStatistics

public void clearStatistics()

Clears sampled statistics for this cache

Specified by:

clearStatistics in interface SampledCacheStatistics

See Also:

SampledCacheStatistics.clearStatistics()

getStatisticsAccuracyDescription

public java.lang.String getStatisticsAccuracyDescription()

Get Description for statisticsAccuracy

Specified by:

getStatisticsAccuracyDescription in interface SampledCacheStatistics

notifyCacheElementEvicted

public void notifyCacheElementEvicted()

Called when an element is expired in the cache

Specified by:

notifyCacheElementEvicted in interface CacheUsageListener

notifyCacheElementExpired

public void notifyCacheElementExpired()

Called when an element in the cache expires

Specified by:

notifyCacheElementExpired in interface CacheUsageListener

notifyCacheElementPut

public void notifyCacheElementPut()

Called when an element is inserted in the cache

Specified by:

notifyCacheElementPut in interface CacheUsageListener

notifyCacheElementRemoved

public void notifyCacheElementRemoved()

Called when an element is removed from the cache

Specified by:

notifyCacheElementRemoved in interface CacheUsageListener

notifyCacheElementUpdated

public void notifyCacheElementUpdated()

Called when an element is updated in the cache, i.e. a put for an already existing key

Specified by:

notifyCacheElementUpdated in interface CacheUsageListener

notifyCacheHitInMemory

public void notifyCacheHitInMemory()

Called on a cache hit in the MemoryStore

Specified by:

notifyCacheHitInMemory in interface CacheUsageListener

notifyCacheHitOnDisk

public void notifyCacheHitOnDisk()

Called on a cache hit in the DiskStore

Specified by:

notifyCacheHitOnDisk in interface CacheUsageListener

notifyCacheMissedWithExpired

public void notifyCacheMissedWithExpired()

Called when an element is found in the cache but already expired

Specified by:

notifyCacheMissedWithExpired in interface CacheUsageListener

notifyCacheMissedWithNotFound

public void notifyCacheMissedWithNotFound()

Called when an element is not found in the cache

Specified by:

notifyCacheMissedWithNotFound in interface CacheUsageListener

notifyRemoveAll

public void notifyRemoveAll()

Called when Cache.removeAll() is called

Specified by:

notifyRemoveAll in interface CacheUsageListener

notifyStatisticsAccuracyChanged

public void notifyStatisticsAccuracyChanged(int statisticsAccuracy)

Notified when the statistics accuracy is changed.

Specified by:

notifyStatisticsAccuracyChanged in interface CacheUsageListener

Parameters:

statisticsAccuracy - one of Statistics#STATISTICS_ACCURACY_BEST_EFFORT, Statistics#STATISTICS_ACCURACY_GUARANTEED, Statistics#STATISTICS_ACCURACY_NONE

notifyStatisticsCleared

public void notifyStatisticsCleared()

Called when statistics is cleared

Specified by:

notifyStatisticsCleared in interface CacheUsageListener

notifyStatisticsEnabledChanged

public void notifyStatisticsEnabledChanged(boolean enableStatistics)

Called when statistics is enabled/disabled

Specified by:

notifyStatisticsEnabledChanged in interface CacheUsageListener

notifyTimeTakenForGet

public void notifyTimeTakenForGet(long millis)

Notified with time taken for a get operation in the cache

Specified by:

notifyTimeTakenForGet in interface CacheUsageListener