org.aspectj.org.eclipse.jdt.internal.core.util

Class LRUCache<K,V>

java.lang.Object

org.aspectj.org.eclipse.jdt.internal.core.util.LRUCache<K,V>

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

OverflowingLRUCache

public class LRUCache<K,V>
extends java.lang.Object
implements java.lang.Cloneable

The LRUCache is a hashtable that stores a finite number of elements. When an attempt is made to add values to a full cache, the least recently used values in the cache are discarded to make room for the new values as necessary.

The data structure is based on the LRU virtual memory paging scheme.

Objects can take up a variable amount of cache space by implementing the ILRUCacheable interface.

This implementation is NOT thread-safe. Synchronization wrappers would have to be added to ensure atomic insertions and deletions from the cache.

See Also:

ILRUCacheable

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LRUCache.LRUCacheEntry<K,V> This type is used internally by the LRUCache to represent entries stored in the cache.
class	LRUCache.Stats

Field Summary

Fields

Modifier and Type	Field and Description
protected int	currentSpace Amount of cache space used so far
protected static int	DEFAULT_SPACELIMIT Default amount of space in the cache
protected LRUCache.LRUCacheEntry<K,V>	entryQueue Start of queue (most recently used entry)
protected LRUCache.LRUCacheEntry<K,V>	entryQueueTail End of queue (least recently used entry)
protected java.util.Hashtable<K,LRUCache.LRUCacheEntry<K,V>>	entryTable Hash table for fast random access to cache entries
protected int	spaceLimit Maximum space allowed in cache
protected int	timestampCounter Counter for handing out sequential timestamps

Constructor Summary

Constructors

Constructor and Description
LRUCache() Creates a new cache.
LRUCache(int size) Creates a new cache.

Method Summary

Modifier and Type	Method and Description
LRUCache<K,V>	clone() Returns a new cache containing the same contents.
double	fillingRatio()
void	flush() Flushes all entries from the cache.
void	flush(K key) Flushes the given entry from the cache.
V	get(K key) Answers the value in the cache at the given key.
int	getCurrentSpace() Returns the amount of space that is current used in the cache.
K	getKey(K key)
int	getNewestTimestampCounter() Returns the timestamps of the most recently used element in the cache.
K	getOldestElement() Returns the lest recently used element in the cache, can return null
int	getOldestTimestampCounter() Returns the timestamps of the least recently used element in the cache.
int	getSpaceLimit() Returns the maximum amount of space available in the cache.
java.util.Enumeration<K>	keys() Returns an Enumeration of the keys currently in the cache.
ICacheEnumeration<K,V>	keysAndValues() Returns an enumeration that iterates over all the keys and values currently in the cache.
protected boolean	makeSpace(int space) Ensures there is the specified amount of free space in the receiver, by removing old entries if necessary.
protected LRUCache<K,V>	newInstance(int size) Returns a new LRUCache instance
V	peek(K key) Answers the value in the cache at the given key.
protected void	privateAdd(K key, V value, int space) Adds an entry for the given key/value/space.
protected void	privateAddEntry(LRUCache.LRUCacheEntry<K,V> entry, boolean shuffle) Adds the given entry from the receiver.
protected void	privateRemoveEntry(LRUCache.LRUCacheEntry<K,V> entry, boolean shuffle) Removes the entry from the entry queue.
V	put(K key, V value) Sets the value in the cache at the given key.
V	removeKey(K key) Removes and returns the value in the cache for the given key.
void	setSpaceLimit(int limit) Sets the maximum amount of space that the cache can store
protected int	spaceFor(V value) Returns the space taken by the given value.
java.lang.String	toString() Returns a String that represents the value of this object.
protected java.lang.String	toStringContents() Returns a String that represents the contents of this object.
java.lang.String	toStringFillingRation(java.lang.String cacheName)
protected void	updateTimestamp(LRUCache.LRUCacheEntry<K,V> entry) Updates the timestamp for the given entry, ensuring that the queue is kept in correct order.

Methods inherited from class java.lang.Object

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

Field Detail

currentSpace

protected int currentSpace

Amount of cache space used so far

spaceLimit

protected int spaceLimit

Maximum space allowed in cache

timestampCounter

protected int timestampCounter

Counter for handing out sequential timestamps

entryTable

protected java.util.Hashtable<K,LRUCache.LRUCacheEntry<K,V>> entryTable

Hash table for fast random access to cache entries

entryQueue

protected LRUCache.LRUCacheEntry<K,V> entryQueue

Start of queue (most recently used entry)

entryQueueTail

protected LRUCache.LRUCacheEntry<K,V> entryQueueTail

End of queue (least recently used entry)

DEFAULT_SPACELIMIT

protected static final int DEFAULT_SPACELIMIT

Default amount of space in the cache

See Also:

Constant Field Values

Constructor Detail

LRUCache

public LRUCache()

Creates a new cache. Size of cache is defined by DEFAULT_SPACELIMIT.

LRUCache

public LRUCache(int size)

Creates a new cache.

Parameters:

size - Size of Cache

Method Detail

clone

public LRUCache<K,V> clone()

Returns a new cache containing the same contents.

Overrides:

clone in class java.lang.Object

Returns:

New copy of object.

fillingRatio

public double fillingRatio()

flush

public void flush()

Flushes all entries from the cache.

flush

public void flush(K key)

Flushes the given entry from the cache. Does nothing if entry does not exist in cache.

Parameters:

key - Key of object to flush

getKey

public K getKey(K key)

get

public V get(K key)

Answers the value in the cache at the given key. If the value is not in the cache, returns null

Parameters:

key - Hash table key of object to retrieve

Returns:

Retrieved object, or null if object does not exist

getCurrentSpace

public int getCurrentSpace()

Returns the amount of space that is current used in the cache.

getNewestTimestampCounter

public int getNewestTimestampCounter()

Returns the timestamps of the most recently used element in the cache.

getOldestTimestampCounter

public int getOldestTimestampCounter()

Returns the timestamps of the least recently used element in the cache.

getOldestElement

public K getOldestElement()

Returns the lest recently used element in the cache, can return null

getSpaceLimit

public int getSpaceLimit()

Returns the maximum amount of space available in the cache.

keys

public java.util.Enumeration<K> keys()

Returns an Enumeration of the keys currently in the cache.

keysAndValues

public ICacheEnumeration<K,V> keysAndValues()

Returns an enumeration that iterates over all the keys and values currently in the cache.

makeSpace

protected boolean makeSpace(int space)

Ensures there is the specified amount of free space in the receiver, by removing old entries if necessary. Returns true if the requested space was made available, false otherwise.

Parameters:

space - Amount of space to free up

newInstance

protected LRUCache<K,V> newInstance(int size)

Returns a new LRUCache instance

peek

public V peek(K key)

Answers the value in the cache at the given key. If the value is not in the cache, returns null This function does not modify timestamps.

privateAdd

protected void privateAdd(K key,
                          V value,
                          int space)

Adds an entry for the given key/value/space.

privateAddEntry

protected void privateAddEntry(LRUCache.LRUCacheEntry<K,V> entry,
                               boolean shuffle)

Adds the given entry from the receiver.

Parameters:

shuffle - Indicates whether we are just shuffling the queue (in which case, the entry table is not modified).

privateRemoveEntry

protected void privateRemoveEntry(LRUCache.LRUCacheEntry<K,V> entry,
                                  boolean shuffle)

Removes the entry from the entry queue.

Parameters:

shuffle - indicates whether we are just shuffling the queue (in which case, the entry table is not modified).

put

public V put(K key,
             V value)

Sets the value in the cache at the given key. Returns the value.

Parameters:

key - Key of object to add.

value - Value of object to add.

Returns:

added value.

removeKey

public V removeKey(K key)

Removes and returns the value in the cache for the given key. If the key is not in the cache, returns null.

Parameters:

key - Key of object to remove from cache.

Returns:

Value removed from cache.

setSpaceLimit

public void setSpaceLimit(int limit)

Sets the maximum amount of space that the cache can store

Parameters:

limit - Number of units of cache space

spaceFor

protected int spaceFor(V value)

Returns the space taken by the given value.

toString

public java.lang.String toString()

Returns a String that represents the value of this object. This method is for debugging purposes only.

Overrides:

toString in class java.lang.Object

toStringContents

protected java.lang.String toStringContents()

Returns a String that represents the contents of this object. This method is for debugging purposes only.

toStringFillingRation

public java.lang.String toStringFillingRation(java.lang.String cacheName)

updateTimestamp

protected void updateTimestamp(LRUCache.LRUCacheEntry<K,V> entry)

Updates the timestamp for the given entry, ensuring that the queue is kept in correct order. The entry must exist