Package io.helidon.security.providers

Class EvictableCache.Builder<K,V>

java.lang.Object

io.helidon.security.providers.EvictableCache.Builder<K,V>

Type Parameters:

K - types of keys used in the cache

V - types of values used in the cache

Enclosing interface:

EvictableCache<K,V>

public static class EvictableCache.Builder<K,V>
extends java.lang.Object

Builder to create instances of EvictableCache.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
<K,V> EvictableCache<K,V>	build() Build a new instance of the cache based on configuration of this builder.
EvictableCache.Builder<K,V>	cacheEnabled(boolean cacheEnabled) If the cacheEnabled is set to false, no caching will be done.
EvictableCache.Builder<K,V>	evictor(java.util.function.BiFunction<K,V,java.lang.Boolean> evictor) Configure evictor to check if a records is still valid.
EvictableCache.Builder<K,V>	evictSchedule(long evictDelay, long evictPeriod, java.util.concurrent.TimeUnit evictTimeUnit) Configure eviction scheduling.
EvictableCache.Builder<K,V>	fromConfig(Config config) Update this builder from configuration.
EvictableCache.Builder<K,V>	maxSize(long cacheMaxSize) Configure maximal cache size.
EvictableCache.Builder<K,V>	parallelismThreshold(long parallelismThreshold) Configure parallelism threshold.
EvictableCache.Builder<K,V>	timeout(long timeout, java.util.concurrent.TimeUnit timeoutUnit) Configure record timeout since last modification.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

build

public <K,V> EvictableCache<K,V> build()

Build a new instance of the cache based on configuration of this builder.

Type Parameters:

K - key type

V - value type

Returns:

a new instance of the cache

timeout

public EvictableCache.Builder<K,V> timeout(long timeout,
                                           java.util.concurrent.TimeUnit timeoutUnit)

Configure record timeout since last modification.

Parameters:

timeout - timeout value

timeoutUnit - timeout unit

Returns:

updated builder instance

maxSize

public EvictableCache.Builder<K,V> maxSize(long cacheMaxSize)

Configure maximal cache size.

Parameters:

cacheMaxSize - maximal number of records to store in the cache

Returns:

updated builder instance

evictSchedule

public EvictableCache.Builder<K,V> evictSchedule(long evictDelay,
                                                 long evictPeriod,
                                                 java.util.concurrent.TimeUnit evictTimeUnit)

Configure eviction scheduling.

Parameters:

evictDelay - delay from the creation of the cache to first eviction

evictPeriod - how often to evict records

evictTimeUnit - time unit to use for these values

Returns:

updated builder instance

parallelismThreshold

public EvictableCache.Builder<K,V> parallelismThreshold(long parallelismThreshold)

Configure parallelism threshold.

Parameters:

parallelismThreshold - see ConcurrentHashMap.forEachKey(long, Consumer)

Returns:

updated builder instance

evictor

public EvictableCache.Builder<K,V> evictor(java.util.function.BiFunction<K,V,java.lang.Boolean> evictor)

Configure evictor to check if a records is still valid. This should be a fast way to check, as it is happening in a ConcurrentHashMap.forEachKey(long, Consumer). This is also called during all get and remove operations to only return valid records.

Parameters:

evictor - evictor to use, return true for records that should be evicted, false for records that should stay in cache

Returns:

updated builder instance

cacheEnabled

public EvictableCache.Builder<K,V> cacheEnabled(boolean cacheEnabled)

If the cacheEnabled is set to false, no caching will be done. Otherwise (default behavior) evictable caching will be used.

Parameters:

cacheEnabled - whether to enable this cache or not (true - enabled by default)

Returns:

updated builder instance

fromConfig

public EvictableCache.Builder<K,V> fromConfig(Config config)

Update this builder from configuration. Options expected under the current config node:

Configuration parameters

key	default value	description
cache-enabled	true	Set to false to fully disable caching (and ignore other parameters)
cache-timeout-millis	minutes	Timeout of records in the cache in milliseconds
cache-evict-delay-millis	minutes	How long to wait with eviction after the cache is created in milliseconds
cache-evict-period-millis	minutes	How often to evict records from the cache in milliseconds
parallelism-treshold		see parallelismThreshold(long)
evictor-class		A class that is instantiated and used as an evictor for this instance

Parameters:

config - Config to use to load configuration options for this builder

Returns:

updated builder instance