com.tangosol.coherence.jcache.common

Class ContextJCacheStatistics

java.lang.Object

com.tangosol.coherence.jcache.common.AbstractJCacheStatistics

com.tangosol.coherence.jcache.common.ContextJCacheStatistics

All Implemented Interfaces:

JCacheStatistics, ExternalizableLite, PortableObject, Serializable, javax.cache.management.CacheStatisticsMXBean

public class ContextJCacheStatistics
extends AbstractJCacheStatistics
implements JCacheStatistics, ExternalizableLite, PortableObject

JCache Statistics implementation. JCache cache statistics differed enough from current Coherence cache statistics that just ended up maintaining statistics separately. Examples of differences include put of same value is optimized in Coherence implementation but JCache considers them 2 distinct puts. (could not pass jsr 107 tck with that behavior) Additionally, coherence does not count removals at the time this was written.

Since:

Coherence 12.1.3

Author:

jf 2013.10.24

Constructor Summary

Constructors

Constructor and Description
ContextJCacheStatistics() Constructs ...
ContextJCacheStatistics(JCacheIdentifier id) Constructs JCacheStatistics for cache id

Method Summary

Modifier and Type	Method and Description
JCacheStatistics	add(JCacheStatistics stats) add JCacheStatistics stats to this instance.
void	clear()
float	getAverageGetTime()
float	getAveragePutTime()
float	getAverageRemoveTime()
long	getCacheEvictions()
long	getCacheGets()
float	getCacheHitPercentage()
long	getCacheHits()
long	getCacheHitsMillis() get time elapsed in milliseconds performing operations resulting in a hit
long	getCacheMisses()
long	getCacheMissesMillis() get time elapsed in milliseconds performing operations resulting in a miss
float	getCacheMissPercentage()
long	getCachePuts()
long	getCachePutsMillis() get time elapsed in milliseconds performing operations resulting in a put
long	getCacheRemovals()
long	getCacheRemoveMillis() get time elapsed in milliseconds performing operations resulting in a remove
JCacheIdentifier	getIdentifier() Get unique JCacheIdentifier for cache that these statistics are for.
void	readExternal(DataInput in) Restore the contents of this object by loading the object's state from the passed DataInput object.
void	readExternal(PofReader in) Restore the contents of a user type instance by reading its state using the specified PofReader object.
void	registerHits(int count, long lStartMillis) add Cache Hits of count and compute time in cache hits
void	registerHitsCompleted(long lStartMillis) Record elapsed time in milliseconds performing hit(s)
void	registerMisses(int count, long lStartMillis) add Cache Misses of count and compute time in cache misses
void	registerMissesCompleted(long lStartMillis) Record elapsed time in milliseconds performing miss(es)
void	registerPuts(long count, long lStartMillis) add Cache Puts of count and compute time in cache puts
void	registerPutsCompleted(long lStartMillis) Record elapsed time performing puts
void	registerRemove() register a Cache Remove
void	registerRemoveCompleted(long lStartMillis) Record elapsed time in milliseconds performing removal(s)
void	registerRemoves(long count, long lStartMillis) add Cache Removals of count and compute time in cache removals
void	writeExternal(DataOutput out) Save the contents of this object by storing the object's state into the passed DataOutput object.
void	writeExternal(PofWriter out) Save the contents of a POF user type instance by writing its state using the specified PofWriter object.

Methods inherited from class com.tangosol.coherence.jcache.common.AbstractJCacheStatistics

toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ContextJCacheStatistics

public ContextJCacheStatistics()

Constructs ...

ContextJCacheStatistics

public ContextJCacheStatistics(JCacheIdentifier id)

Constructs JCacheStatistics for cache id

Parameters:

id - unique JCache cache identifier

Method Detail

registerHits

public void registerHits(int count,
                         long lStartMillis)

Description copied from interface: JCacheStatistics

add Cache Hits of count and compute time in cache hits

Specified by:

registerHits in interface JCacheStatistics

Parameters:

count - number of cache entry lookup hits

lStartMillis - start time in milliseconds for computing time performing lookup when there were hits.

registerMisses

public void registerMisses(int count,
                           long lStartMillis)

Description copied from interface: JCacheStatistics

add Cache Misses of count and compute time in cache misses

Specified by:

registerMisses in interface JCacheStatistics

Parameters:

count - number of cache entry lookup misses

lStartMillis - start time of cache entry lookup that resulted in misses

registerPuts

public void registerPuts(long count,
                         long lStartMillis)

Description copied from interface: JCacheStatistics

add Cache Puts of count and compute time in cache puts

Specified by:

registerPuts in interface JCacheStatistics

Parameters:

count - number of cache entry puts

lStartMillis - start time in milliseconds of put(s) operation

registerPutsCompleted

public void registerPutsCompleted(long lStartMillis)

Description copied from interface: JCacheStatistics

Record elapsed time performing puts

Specified by:

registerPutsCompleted in interface JCacheStatistics

Parameters:

lStartMillis - start time in milliseconds of put(s) operation

registerRemoves

public void registerRemoves(long count,
                            long lStartMillis)

Description copied from interface: JCacheStatistics

add Cache Removals of count and compute time in cache removals

Specified by:

registerRemoves in interface JCacheStatistics

Parameters:

count - number of cache entry removals

lStartMillis - start time in milliseconds of removal(s) operation

registerRemove

public void registerRemove()

Description copied from interface: JCacheStatistics

register a Cache Remove

Specified by:

registerRemove in interface JCacheStatistics

registerHitsCompleted

public void registerHitsCompleted(long lStartMillis)

Description copied from interface: JCacheStatistics

Record elapsed time in milliseconds performing hit(s)

Specified by:

registerHitsCompleted in interface JCacheStatistics

Parameters:

lStartMillis - start time in milliseconds of operation that resulted in a hit(s)

registerMissesCompleted

public void registerMissesCompleted(long lStartMillis)

Description copied from interface: JCacheStatistics

Record elapsed time in milliseconds performing miss(es)

Specified by:

registerMissesCompleted in interface JCacheStatistics

Parameters:

lStartMillis - start time in milliseconds of operation that resulted in miss(es)

registerRemoveCompleted

public void registerRemoveCompleted(long lStartMillis)

Description copied from interface: JCacheStatistics

Record elapsed time in milliseconds performing removal(s)

Specified by:

registerRemoveCompleted in interface JCacheStatistics

Parameters:

lStartMillis - start time in milliseconds of operation that resulted in removal(s)

getIdentifier

public JCacheIdentifier getIdentifier()

Description copied from interface: JCacheStatistics

Get unique JCacheIdentifier for cache that these statistics are for.

Specified by:

getIdentifier in interface JCacheStatistics

Returns:

unique JCacheIdentifier

add

public JCacheStatistics add(JCacheStatistics stats)

Description copied from interface: JCacheStatistics

add JCacheStatistics stats to this instance.

Specified by:

add in interface JCacheStatistics

Parameters:

stats - JCacheStatistics from another data-enabled server

Returns:

the addition of stats to this instance

getCacheHitsMillis

public long getCacheHitsMillis()

Description copied from interface: JCacheStatistics

get time elapsed in milliseconds performing operations resulting in a hit

Specified by:

getCacheHitsMillis in interface JCacheStatistics

Returns:

duration of operations that resulted in cache entry hit

getCacheMissesMillis

public long getCacheMissesMillis()

Description copied from interface: JCacheStatistics

get time elapsed in milliseconds performing operations resulting in a miss

Specified by:

getCacheMissesMillis in interface JCacheStatistics

Returns:

duration of operations that resulted in cache entry miss

getCachePutsMillis

public long getCachePutsMillis()

Description copied from interface: JCacheStatistics

get time elapsed in milliseconds performing operations resulting in a put

Specified by:

getCachePutsMillis in interface JCacheStatistics

Returns:

duration of operations that resulted in cache entry put

getCacheRemoveMillis

public long getCacheRemoveMillis()

Description copied from interface: JCacheStatistics

get time elapsed in milliseconds performing operations resulting in a remove

Specified by:

getCacheRemoveMillis in interface JCacheStatistics

Returns:

duration of operations that resulted in cache entry remove

clear

public void clear()

Specified by:

clear in interface JCacheStatistics

Specified by:

clear in interface javax.cache.management.CacheStatisticsMXBean

getCacheHits

public long getCacheHits()

Specified by:

getCacheHits in interface JCacheStatistics

Specified by:

getCacheHits in interface javax.cache.management.CacheStatisticsMXBean

getCacheHitPercentage

public float getCacheHitPercentage()

Specified by:

getCacheHitPercentage in interface JCacheStatistics

Specified by:

getCacheHitPercentage in interface javax.cache.management.CacheStatisticsMXBean

getCacheMisses

public long getCacheMisses()

Specified by:

getCacheMisses in interface JCacheStatistics

Specified by:

getCacheMisses in interface javax.cache.management.CacheStatisticsMXBean

getCacheMissPercentage

public float getCacheMissPercentage()

Specified by:

getCacheMissPercentage in interface JCacheStatistics

Specified by:

getCacheMissPercentage in interface javax.cache.management.CacheStatisticsMXBean

getCacheGets

public long getCacheGets()

Specified by:

getCacheGets in interface JCacheStatistics

Specified by:

getCacheGets in interface javax.cache.management.CacheStatisticsMXBean

getCachePuts

public long getCachePuts()

Specified by:

getCachePuts in interface JCacheStatistics

Specified by:

getCachePuts in interface javax.cache.management.CacheStatisticsMXBean

getCacheRemovals

public long getCacheRemovals()

Specified by:

getCacheRemovals in interface JCacheStatistics

Specified by:

getCacheRemovals in interface javax.cache.management.CacheStatisticsMXBean

getCacheEvictions

public long getCacheEvictions()

Specified by:

getCacheEvictions in interface JCacheStatistics

Specified by:

getCacheEvictions in interface javax.cache.management.CacheStatisticsMXBean

getAverageGetTime

public float getAverageGetTime()

Specified by:

getAverageGetTime in interface JCacheStatistics

Specified by:

getAverageGetTime in interface javax.cache.management.CacheStatisticsMXBean

getAveragePutTime

public float getAveragePutTime()

Specified by:

getAveragePutTime in interface JCacheStatistics

Specified by:

getAveragePutTime in interface javax.cache.management.CacheStatisticsMXBean

getAverageRemoveTime

public float getAverageRemoveTime()

Specified by:

getAverageRemoveTime in interface JCacheStatistics

Specified by:

getAverageRemoveTime in interface javax.cache.management.CacheStatisticsMXBean

readExternal

public void readExternal(PofReader in)
                  throws IOException

Description copied from interface: PortableObject

Restore the contents of a user type instance by reading its state using the specified PofReader object.

Specified by:

readExternal in interface PortableObject

Parameters:

in - the PofReader from which to read the object's state

Throws:

IOException - if an I/O error occurs

writeExternal

public void writeExternal(PofWriter out)
                   throws IOException

Description copied from interface: PortableObject

Save the contents of a POF user type instance by writing its state using the specified PofWriter object.

Specified by:

writeExternal in interface PortableObject

Parameters:

out - the PofWriter to which to write the object's state

Throws:

IOException - if an I/O error occurs

readExternal

public void readExternal(DataInput in)
                  throws IOException

Description copied from interface: ExternalizableLite

Restore the contents of this object by loading the object's state from the passed DataInput object.

Specified by:

readExternal in interface ExternalizableLite

Parameters:

in - the DataInput stream to read data from in order to restore the state of this object

Throws:

IOException - if an I/O exception occurs

NotActiveException - if the object is not in its initial state, and therefore cannot be deserialized into

writeExternal

public void writeExternal(DataOutput out)
                   throws IOException

Description copied from interface: ExternalizableLite

Save the contents of this object by storing the object's state into the passed DataOutput object.

Specified by:

writeExternal in interface ExternalizableLite

Parameters:

out - the DataOutput stream to write the state of this object to

Throws:

IOException - if an I/O exception occurs