com.cloudant.client.cache

Interface CacheWithLifetimes<K,V>

All Superinterfaces:

Cache<K,V>

All Known Implementing Classes:

RedisCache

public interface CacheWithLifetimes<K,V>
extends Cache<K,V>

Method Summary

Modifier and Type	Method and Description
CacheEntry<V>	getCacheEntry(K key) Look up a CacheEntry in the cache.
void	put(K key, V value, long lifetime) Cache a key-value pair.
void	putAll(java.util.Map<K,V> map, long lifetime) Cache one or more key-value pairs.

Methods inherited from interface com.cloudant.client.cache.Cache

clear, delete, deleteAll, get, getAll, getStatistics, put, putAll, size

Method Detail

put

void put(K key,
         V value,
         long lifetime)

Cache a key-value pair.

Parameters:

key - key associated with value

value - value associated with key

lifetime - lifetime in milliseconds associated with data

putAll

void putAll(java.util.Map<K,V> map,
            long lifetime)

Cache one or more key-value pairs.

Parameters:

map - map containing key-value pairs to cache

lifetime - lifetime in milliseconds associated with each key-value pair. If the system supports revalidation of expired cache entries to determine if expired entries are really obsolete, a value <= 0 indicates cached entry should always be revalidated before being returned to client

getCacheEntry

CacheEntry<V> getCacheEntry(K key)

Look up a CacheEntry in the cache. The CacheEntry may correspond to expired data. This method can be used to revalidate cached objects whose expiration times have passed.

Parameters:

key - key corresponding to value

Returns:

value corresponding to key (may be expired), null if key is not in cache