com.alicp.jetcache

Class RefreshCache<K,V>

java.lang.Object

com.alicp.jetcache.SimpleProxyCache<K,V>

com.alicp.jetcache.LoadingCache<K,V>

com.alicp.jetcache.RefreshCache<K,V>

All Implemented Interfaces:

Cache<K,V>, ProxyCache<K,V>, Closeable, AutoCloseable

public class RefreshCache<K,V>
extends LoadingCache<K,V>

Created on 2017/5/25.

Author:

huangli

Constructor Summary

Constructors

Constructor and Description
RefreshCache(Cache cache)

Method Summary

Modifier and Type	Method and Description
void	close() Clean resources created by this cache.
V	computeIfAbsent(K key, Function<K,V> loader) If there is a value associated with the key, return the value; otherwise use the loader load the value and return, and then update the cache.
V	computeIfAbsent(K key, Function<K,V> loader, boolean cacheNullWhenLoaderReturnNull) If there is a value associated with the key, return the value; otherwise use the loader load the value and return, and then update the cache.
V	computeIfAbsent(K key, Function<K,V> loader, boolean cacheNullWhenLoaderReturnNull, long expireAfterWrite, TimeUnit timeUnit) If there is a value associated with the key, return the value; otherwise use the loader load the value and return, and then update the cache.
V	get(K key) Gets an entry from the cache.
Map<K,V>	getAll(Set<? extends K> keys) Gets a collection of entries from the Cache, returning them as Map of the values associated with the set of keys requested.

Methods inherited from class com.alicp.jetcache.SimpleProxyCache

config, GET_ALL, GET, getTargetCache, PUT_ALL, PUT_ALL, PUT_IF_ABSENT, put, PUT, put, PUT, putAll, putAll, putIfAbsent, REMOVE_ALL, remove, REMOVE, removeAll, tryLock, tryLockAndRun, unwrap

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RefreshCache

public RefreshCache(Cache cache)

Method Detail

close

public void close()

Description copied from interface: Cache

Clean resources created by this cache.

Specified by:

close in interface Cache<K,V>

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class SimpleProxyCache<K,V>

computeIfAbsent

public V computeIfAbsent(K key,
                         Function<K,V> loader)

Description copied from interface: Cache

If there is a value associated with the key, return the value; otherwise use the loader load the value and return, and then update the cache.

Specified by:

computeIfAbsent in interface Cache<K,V>

Overrides:

computeIfAbsent in class SimpleProxyCache<K,V>

Parameters:

key - the key

loader - the value loader

Returns:

the value

See Also:

CacheConfig.isCacheNullValue()

computeIfAbsent

public V computeIfAbsent(K key,
                         Function<K,V> loader,
                         boolean cacheNullWhenLoaderReturnNull)

Description copied from interface: Cache

If there is a value associated with the key, return the value; otherwise use the loader load the value and return, and then update the cache.

Specified by:

computeIfAbsent in interface Cache<K,V>

Overrides:

computeIfAbsent in class SimpleProxyCache<K,V>

Parameters:

key - the key

loader - the value loader

cacheNullWhenLoaderReturnNull - true if null value returned by loader should put into cache use the key

Returns:

the value

computeIfAbsent

public V computeIfAbsent(K key,
                         Function<K,V> loader,
                         boolean cacheNullWhenLoaderReturnNull,
                         long expireAfterWrite,
                         TimeUnit timeUnit)

Description copied from interface: Cache

If there is a value associated with the key, return the value; otherwise use the loader load the value and return, and then update the cache.

Specified by:

computeIfAbsent in interface Cache<K,V>

Overrides:

computeIfAbsent in class SimpleProxyCache<K,V>

Parameters:

key - the key

loader - the value loader

cacheNullWhenLoaderReturnNull - true if null value returned by loader should put into cache use the key

expireAfterWrite - the TTL(time to live) of the KV association

timeUnit - the time unit of expireAfterWrite

Returns:

the value

get

public V get(K key)
      throws CacheInvokeException

Description copied from interface: Cache

Gets an entry from the cache.

If the cache's builder has specified a CacheLoader and there is no association in the cache , it will attempt to load the entry.

If error occurs during cache access, the method return null instead of throwing an exception.

Specified by:

get in interface Cache<K,V>

Overrides:

get in class LoadingCache<K,V>

Parameters:

key - the key whose associated value is to be returned

Returns:

the associated value. null may indicates:

• the entry does not exist or expired
• the entry value is null
• error occurs during cache access(no exception throws)

Throws:

CacheInvokeException - only if loader throws an exception

See Also:

CacheLoader, Cache.GET(Object)

getAll

public Map<K,V> getAll(Set<? extends K> keys)
                throws CacheInvokeException

Description copied from interface: Cache

Gets a collection of entries from the Cache, returning them as Map of the values associated with the set of keys requested.

If the cache's builder has specified a CacheLoader and there is no association in the cache , it will attempt to load the entry.

If error occurs during cache access, the method will not throw an exception.

Specified by:

getAll in interface Cache<K,V>

Overrides:

getAll in class LoadingCache<K,V>

Parameters:

keys - The keys whose associated values are to be returned.

Returns:

A map of entries that were found for the given keys. Keys not found in the cache are not in the returned map.

Throws:

CacheInvokeException - only if loader throws an exception

See Also:

CacheLoader, Cache.GET_ALL(Set)