edu.brandeis.cs.steele.util
Interface Cache

All Known Implementing Classes:
LRUCache

public interface Cache

A Cache is a collection of values that are indexed by keys and that are stored for an unspecified amount of time (which the implementor of Cache may further specify).

Author:
Oliver Steele, steele@cs.brandeis.edu

Method Summary
 void clear()
          Remove all values stored in this cache.
 java.lang.Object get(java.lang.Object key)
          If key was used in a previous call to put, this call may return the value of that call.
 void put(java.lang.Object key, java.lang.Object value)
          Store value in the cache, indexed by key.
 

Method Detail

put

void put(java.lang.Object key,
         java.lang.Object value)
Store value in the cache, indexed by key. This operation makes it likely, although not certain, that a subsquent call to get with the same (equal) key will retrieve the same (==) value.

Multiple calls to put with the same key and value are idempotent. A set of calls to put with the same key but different values has only the affect of the last call (assuming there were no intervening calls to get).


get

java.lang.Object get(java.lang.Object key)
If key was used in a previous call to put, this call may return the value of that call. Otherwise it returns null.


clear

void clear()
Remove all values stored in this cache. Subsequent calls to get will return null.