jodd.cache.AbstractCacheMap Maven / Gradle / Ivy
// Copyright (c) 2003-2011, Jodd Team (jodd.org). All Rights Reserved.
package jodd.cache;
import java.util.Iterator;
import java.util.Map;
/**
* Default implementation of timed and size cache map.
* Implementations should:
*
* - create a new cache map
*
- implements own
prune strategy
*
*/
public abstract class AbstractCacheMap implements Cache {
class CacheObject {
CacheObject(K2 key, V2 object, long ttl) {
this.key = key;
this.cachedObject = object;
this.ttl = ttl;
this.lastAccess = System.currentTimeMillis();
}
final K2 key;
final V2 cachedObject;
long lastAccess; // time of last access
int accessCount; // number of accesses
long ttl; // objects timeout (time-to-live), 0 = no timeout
boolean isExpired() {
if (ttl == 0) {
return false;
}
return lastAccess + ttl < System.currentTimeMillis();
}
V2 getObject() {
lastAccess = System.currentTimeMillis();
accessCount++;
return cachedObject;
}
}
protected Map> cacheMap;
// ---------------------------------------------------------------- properties
protected int cacheSize; // max cache size, 0 = no limit
/**
* {@inheritDoc}
*/
public int getCacheSize() {
return cacheSize;
}
protected long timeout; // default timeout, 0 = no timeout
/**
* Returns default cache timeout or 0 if it is not set.
* Timeout can be set individually for each object.
*/
public long getCacheTimeout() {
return timeout;
}
/**
* Identifies if objects has custom timeouts.
* Should be used to determine if prune for existing objects is needed.
*/
protected boolean existCustomTimeout;
/**
* Returns true if prune of expired objects should be invoked.
* For internal use.
*/
protected boolean isPruneExpiredActive() {
return (timeout != 0) || existCustomTimeout;
}
// ---------------------------------------------------------------- put
/**
* {@inheritDoc}
*/
public void put(K key, V object) {
put(key, object, timeout);
}
/**
* {@inheritDoc}
*/
public void put(K key, V object, long timeout) {
CacheObject co = new CacheObject(key, object, timeout);
if (timeout != 0) {
existCustomTimeout = true;
}
if (isFull()) {
prune();
}
cacheMap.put(key, co);
}
// ---------------------------------------------------------------- get
/**
* {@inheritDoc}
*/
public V get(K key) {
CacheObject co = cacheMap.get(key);
if (co == null) {
return null;
}
if (co.isExpired() == true) {
remove(key);
return null;
}
return co.getObject();
}
/**
* {@inheritDoc}
*/
public Iterator iterator() {
return new CacheValuesIterator(this);
}
// ---------------------------------------------------------------- prune
/**
* {@inheritDoc}
*/
public abstract int prune();
// ---------------------------------------------------------------- common
/**
* {@inheritDoc}
*/
public boolean isFull() {
if (cacheSize == 0) {
return false;
}
return cacheMap.size() >= cacheSize;
}
/**
* {@inheritDoc}
*/
public void remove(K key) {
cacheMap.remove(key);
}
/**
* {@inheritDoc}
*/
public void clear() {
cacheMap.clear();
}
/**
* {@inheritDoc}
*/
public int size() {
return cacheMap.size();
}
/**
* {@inheritDoc}
*/
public boolean isEmpty() {
return size() == 0;
}
}