net.imglib2.cache.volatiles

Interface AbstractVolatileCache<K,V>

All Superinterfaces:

Invalidate<K>

All Known Subinterfaces:

VolatileCache<K,V>, VolatileLoaderCache<K,V>, VolatileLoaderRemoverCache<K,V,D>, VolatileRemoverCache<K,V,D>

All Known Implementing Classes:

VolatileLoaderCacheAsVolatileCacheAdapter, WeakRefVolatileCache, WeakRefVolatileLoaderCache

public interface AbstractVolatileCache<K,V>
extends Invalidate<K>

Field Summary

Fields inherited from interface net.imglib2.cache.Invalidate

defaultParallelismThreshold

Method Summary

Modifier and Type	Method and Description
V	getIfPresent(K key, CacheHints cacheHints)
void	invalidate(K key) Removes and discards the entry with the specified key.
void	invalidateAll(long parallelismThreshold) Removes and discards all entries.
void	invalidateIf(long parallelismThreshold, Predicate<K> condition) Removes and discards all entries with keys matching condition.

Methods inherited from interface net.imglib2.cache.Invalidate

invalidateAll, invalidateIf

Method Detail

getIfPresent

V getIfPresent(K key,
               CacheHints cacheHints)
        throws ExecutionException

Throws:

ExecutionException

invalidate

void invalidate(K key)

Removes and discards the entry with the specified key. Calls CacheRemover.invalidate(Object) for the discarded entry, (which should in turn remove it from any backing cache)

Note that this will not call CacheRemover.onRemoval(Object, Object) for the discarded entry.

There must be no concurrent get() operations for key. This may result in cache corruption and/or a deadlock.

Specified by:

invalidate in interface Invalidate<K>

Parameters:

key - key of the entry to remove

invalidateIf

void invalidateIf(long parallelismThreshold,
                  Predicate<K> condition)

Removes and discards all entries with keys matching condition. Calls Invalidate.invalidateIf(Predicate) for the discarded entries, (which should in turn remove them from any backing cache)

Note that this will not call CacheRemover.onRemoval(Object, Object) for the discarded entries.

There must be no concurrent get() operations for keys matching condition. This may result in cache corruption and/or a deadlock.

Specified by:

invalidateIf in interface Invalidate<K>

Parameters:

parallelismThreshold - the (estimated) number of entries in the cache needed for this operation to be executed in parallel

condition - condition on keys of entries to remove

invalidateAll

void invalidateAll(long parallelismThreshold)

Removes and discards all entries. Calls Invalidate.invalidateAll() (which should in turn invalidate any backing cache)

Note that this will not call CacheRemover.onRemoval(Object, Object) for the discarded entries.

There must be no concurrent get() operations. This may result in cache corruption and/or a deadlock.

Specified by:

invalidateAll in interface Invalidate<K>

Parameters:

parallelismThreshold - the (estimated) number of entries in the cache needed for this operation to be executed in parallel