de.ipcon.tools.ref

Class SoftReferenceCache

java.lang.Object

de.ipcon.tools.ref.SoftReferenceCache

All Implemented Interfaces:

CacheI, ExpungingCacheI

public class SoftReferenceCache
extends java.lang.Object
implements ExpungingCacheI, CacheI

Constructor Summary

Constructors

Constructor and Description
SoftReferenceCache()
SoftReferenceCache(CacheFetcherI _fetcher, DependencyCalculatorI _dependencyCalculator, java.util.Map _cache)
SoftReferenceCache(CacheFetcherI _fetcher, DependencyCalculatorI _dependencyCalculator, java.util.Map _cache, java.lang.Class _cachedClass)
SoftReferenceCache(CacheFetcherI _fetcher, java.util.Map _cache)
SoftReferenceCache(CacheFetcherI _fetcher, java.util.Map _cache, java.lang.Class _cachedClass)
SoftReferenceCache(java.lang.Class _cachedClass)
SoftReferenceCache(java.util.Map _cache)
SoftReferenceCache(java.util.Map _cache, java.lang.Class _cachedClass)

Method Summary

Modifier and Type	Method and Description
void	clear()
java.lang.Object	computeIfAbsent(java.lang.Object key, java.util.function.Function mappingFunction) Returns the value associated with the specified key, computing it if necessary.
boolean	contains(java.lang.Object key)
void	expunge(java.lang.Object key)
void	expungeAll(java.lang.Object[] keys)
void	expungeAllForDependencies(long[] deps)
void	expungeAllForDependencies(java.lang.Long[] deps)
void	expungeForDependency(long dep)
void	expungeForDependency(java.lang.Long dep)
java.lang.Object	get(java.lang.Object key)
java.lang.Object[]	get(java.lang.Object[] keys)
java.lang.Object[]	get(java.lang.Object[] keys, boolean dontCacheNulls)
java.lang.Object[]	get(java.lang.Object[] keys, boolean dontCacheNulls, boolean dontFetch)
java.lang.Object	get(java.lang.Object key, boolean dontCacheNulls)
java.lang.Object	get(java.lang.Object key, boolean dontCacheNulls, boolean dontFetch)
java.lang.Object	getAt(java.lang.Object key)
ExpungeableReferenceI	getExpungeableReference(java.lang.Object key)
java.util.Set	keySet()
void	put(java.lang.Object key, java.lang.Object value)
void	put(java.lang.Object key, java.lang.Object value, boolean dontCacheNulls)
void	put(java.lang.Object key, java.lang.Object value, boolean dontCacheNulls, long[] dependencies)
void	putAt(java.lang.Object key, java.lang.Object value)
java.lang.Object	putIfAbsent(java.lang.Object key, java.lang.Object value) Associates the specified key with the given value if it is not already associated with a live value.
void	remove(java.lang.Object key)
int	size()
java.util.Collection	values()

Methods inherited from class java.lang.Object

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

Constructor Detail

SoftReferenceCache

public SoftReferenceCache()

SoftReferenceCache

public SoftReferenceCache(java.lang.Class _cachedClass)

SoftReferenceCache

public SoftReferenceCache(java.util.Map _cache)

SoftReferenceCache

public SoftReferenceCache(java.util.Map _cache,
                          java.lang.Class _cachedClass)

SoftReferenceCache

public SoftReferenceCache(CacheFetcherI _fetcher,
                          DependencyCalculatorI _dependencyCalculator,
                          java.util.Map _cache)

SoftReferenceCache

public SoftReferenceCache(CacheFetcherI _fetcher,
                          DependencyCalculatorI _dependencyCalculator,
                          java.util.Map _cache,
                          java.lang.Class _cachedClass)

SoftReferenceCache

public SoftReferenceCache(CacheFetcherI _fetcher,
                          java.util.Map _cache)

SoftReferenceCache

public SoftReferenceCache(CacheFetcherI _fetcher,
                          java.util.Map _cache,
                          java.lang.Class _cachedClass)

Method Detail

getAt

public java.lang.Object getAt(java.lang.Object key)

get

public java.lang.Object[] get(java.lang.Object[] keys)

Specified by:

get in interface CacheI

get

public java.lang.Object[] get(java.lang.Object[] keys,
                              boolean dontCacheNulls)

get

public java.lang.Object[] get(java.lang.Object[] keys,
                              boolean dontCacheNulls,
                              boolean dontFetch)

get

public java.lang.Object get(java.lang.Object key)

Specified by:

get in interface CacheI

Specified by:

get in interface ExpungingCacheI

get

public java.lang.Object get(java.lang.Object key,
                            boolean dontCacheNulls)

get

public java.lang.Object get(java.lang.Object key,
                            boolean dontCacheNulls,
                            boolean dontFetch)

getExpungeableReference

public ExpungeableReferenceI getExpungeableReference(java.lang.Object key)

Specified by:

getExpungeableReference in interface ExpungingCacheI

putAt

public void putAt(java.lang.Object key,
                  java.lang.Object value)

put

public void put(java.lang.Object key,
                java.lang.Object value)

Specified by:

put in interface CacheI

put

public void put(java.lang.Object key,
                java.lang.Object value,
                boolean dontCacheNulls)

put

public void put(java.lang.Object key,
                java.lang.Object value,
                boolean dontCacheNulls,
                long[] dependencies)

remove

public void remove(java.lang.Object key)

Specified by:

remove in interface CacheI

expunge

public void expunge(java.lang.Object key)

Specified by:

expunge in interface ExpungingCacheI

expungeAll

public void expungeAll(java.lang.Object[] keys)

Specified by:

expungeAll in interface ExpungingCacheI

expungeForDependency

public void expungeForDependency(long dep)

Specified by:

expungeForDependency in interface ExpungingCacheI

expungeForDependency

public void expungeForDependency(java.lang.Long dep)

Specified by:

expungeForDependency in interface ExpungingCacheI

expungeAllForDependencies

public void expungeAllForDependencies(long[] deps)

Specified by:

expungeAllForDependencies in interface ExpungingCacheI

expungeAllForDependencies

public void expungeAllForDependencies(java.lang.Long[] deps)

Specified by:

expungeAllForDependencies in interface ExpungingCacheI

values

public java.util.Collection values()

keySet

public java.util.Set keySet()

contains

public boolean contains(java.lang.Object key)

Specified by:

contains in interface CacheI

clear

public void clear()

Specified by:

clear in interface CacheI

size

public int size()

putIfAbsent

public java.lang.Object putIfAbsent(java.lang.Object key,
                                    java.lang.Object value)

Associates the specified key with the given value if it is not already associated with a live value.

Treats "ghost entries" (keys with GC-cleared SoftReferences) as absent, replacing them with the new value atomically.

Parameters:

key - key with which the specified value is to be associated

value - value to be associated with the specified key

Returns:

the previous live value associated with the key, or the new value

Throws:

java.lang.IllegalStateException - if the map is not concurrent or dependency tracking is enabled

computeIfAbsent

public java.lang.Object computeIfAbsent(java.lang.Object key,
                                        java.util.function.Function mappingFunction)

Returns the value associated with the specified key, computing it if necessary.

Handles the "Ghost Entry" problem by checking if an existing SoftReference has been cleared. If cleared, it re-computes the value.

Specified by:

computeIfAbsent in interface CacheI

Parameters:

key - the key with which the specified value is to be associated

mappingFunction - the function to compute a value if missing

Returns:

the current live value associated with the key

Throws:

java.lang.IllegalStateException - if the underlying map is not concurrent