Module org.apache.jena.base

Package org.apache.jena.atlas.lib.cache

Class CacheCaffeine<K,V>

java.lang.Object

org.apache.jena.atlas.lib.cache.CacheCaffeine<K,V>

All Implemented Interfaces:

Cache<K,V>

public final class CacheCaffeine<K,V>
extends Object
implements Cache<K,V>

Wrapper around a com.github.benmanes.caffeine

Constructor Summary

Constructors

Constructor	Description
CacheCaffeine(int size)
CacheCaffeine(int size, BiConsumer<K,V> dropHandler)
CacheCaffeine(int size, BiConsumer<K,V> dropHandler, double initialCapacityFactor)
CacheCaffeine(com.github.benmanes.caffeine.cache.Cache<K,V> caffeine)

Method Summary

Modifier and Type	Method	Description
void	cleanUp()	Forces the cache to clean up stale entries
void	clear()
boolean	containsKey(K key)	Does the cache contain the key?
V	get(K key, Function<K,V> f)	Get from cache; if not present, call the Function to fill the cache slot.
V	getIfPresent(K key)	Get from cache - or return null.
boolean	isEmpty()
Iterator<K>	keys()	Iterate over all keys.
void	put(K key, V thing)	Insert into the cache
void	remove(K key)	Remove from cache - return true if key referenced an entry
long	size()	Current size of cache

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jena.atlas.lib.Cache

getOrFill, stats

Constructor Details

CacheCaffeine

public CacheCaffeine(int size)

CacheCaffeine

public CacheCaffeine(int size,
 BiConsumer<K,V> dropHandler)

CacheCaffeine

public CacheCaffeine(int size,
 BiConsumer<K,V> dropHandler,
 double initialCapacityFactor)

CacheCaffeine

public CacheCaffeine(com.github.benmanes.caffeine.cache.Cache<K,V> caffeine)

Method Details

get

public V get(K key,
 Function<K,V> f)

Description copied from interface: Cache

Get from cache; if not present, call the Function to fill the cache slot. This operation should be atomic.

Specified by:

get in interface Cache<K,V>

Parameters:

key - The key, for which the value should be returned or calculated. The key must not be null.

f - If the cache does not contain the key, the callable is called to calculate a value. If the callable returns null, the key is not associated with hat value, as nulls are not accepted as values. The callable must not be null.

Returns:

Returns either the existing value or the calculated value. If callable is called and returns null, then null is returned.

getIfPresent

public V getIfPresent(K key)

Description copied from interface: Cache

Get from cache - or return null.

Specified by:

getIfPresent in interface Cache<K,V>

Parameters:

key - The key for which the value is requested. The key must not be null.

Returns:

If the cache contains an entry for the given key, the value is returned, otherwise null.

put

public void put(K key,
 V thing)

Description copied from interface: Cache

Insert into the cache

Specified by:

put in interface Cache<K,V>

Parameters:

key - The key for the 'thing' to store. The key must not be null.

thing - If 'thing' is null, it will not be used as value, instead any existing entry with the same key will be removed.

containsKey

public boolean containsKey(K key)

Description copied from interface: Cache

Does the cache contain the key?

Specified by:

containsKey in interface Cache<K,V>

Parameters:

key - The key to find. The key must not be null.

Returns:

True, if the cache contains the key, otherwise false.

remove

public void remove(K key)

Description copied from interface: Cache

Remove from cache - return true if key referenced an entry

Specified by:

remove in interface Cache<K,V>

Parameters:

key - The key, which shall be removed along with its value. The key must not be null.

keys

public Iterator<K> keys()

Description copied from interface: Cache

Iterate over all keys. Iterating over the keys requires the caller be thread-safe.

Specified by:

keys in interface Cache<K,V>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Cache<K,V>

clear

public void clear()

Specified by:

clear in interface Cache<K,V>

size

public long size()

Description copied from interface: Cache

Current size of cache

Specified by:

size in interface Cache<K,V>

cleanUp

public void cleanUp()

Forces the cache to clean up stale entries