net.jodah.expiringmap

Class ExpiringMap.Builder<K,V>

java.lang.Object

net.jodah.expiringmap.ExpiringMap.Builder<K,V>

Enclosing class:

ExpiringMap<K,V>

public static final class ExpiringMap.Builder<K,V>
extends Object

Builds ExpiringMap instances. Defaults to ExpirationPolicy.CREATED and expiration of 60 TimeUnit.SECONDS.

Method Summary

Modifier and Type	Method and Description
<K1 extends K,V1 extends V> ExpiringMap<K1,V1>	build() Builds and returns an expiring map.
<K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1>	entryLoader(EntryLoader<? super K1,? super V1> loader) Sets the EntryLoader to use when loading entries.
ExpiringMap.Builder<K,V>	expiration(long duration, TimeUnit timeUnit) Sets the default map entry expiration.
<K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1>	expirationListener(ExpirationListener<? super K1,? super V1> listener) Sets the expiration listener which will receive notifications upon each map entry's expiration.
<K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1>	expirationListeners(List<ExpirationListener<? super K1,? super V1>> listeners) Sets expiration listeners which will receive notifications upon each map entry's expiration.
ExpiringMap.Builder<K,V>	expirationPolicy(ExpirationPolicy expirationPolicy) Sets the map entry expiration policy.
<K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1>	expiringEntryLoader(ExpiringEntryLoader<? super K1,? super V1> loader) Sets the ExpiringEntryLoader to use when loading entries and configures variable expiration.
ExpiringMap.Builder<K,V>	variableExpiration() Allows for map entries to have individual expirations and for expirations to be changed.

Methods inherited from class java.lang.Object

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

Method Detail

build

public <K1 extends K,V1 extends V> ExpiringMap<K1,V1> build()

Builds and returns an expiring map.

Type Parameters:

K1 - Key type

V1 - Value type

expiration

public ExpiringMap.Builder<K,V> expiration(long duration,
                                           TimeUnit timeUnit)

Sets the default map entry expiration.

Parameters:

duration - the length of time after an entry is created that it should be removed

timeUnit - the unit that duration is expressed in

Throws:

NullPointerException - if timeUnit is null

entryLoader

public <K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1> entryLoader(EntryLoader<? super K1,? super V1> loader)

Sets the EntryLoader to use when loading entries. Either an EntryLoader or ExpiringEntryLoader may be set, not both.

Parameters:

loader - to set

Throws:

NullPointerException - if loader is null

IllegalStateException - if an ExpiringEntryLoader is set

expiringEntryLoader

public <K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1> expiringEntryLoader(ExpiringEntryLoader<? super K1,? super V1> loader)

Sets the ExpiringEntryLoader to use when loading entries and configures variable expiration. Either an EntryLoader or ExpiringEntryLoader may be set, not both.

Parameters:

loader - to set

Throws:

NullPointerException - if loader is null

IllegalStateException - if an EntryLoader is set

expirationListener

public <K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1> expirationListener(ExpirationListener<? super K1,? super V1> listener)

Sets the expiration listener which will receive notifications upon each map entry's expiration.

Parameters:

listener - to set

Throws:

NullPointerException - if listener is null

expirationListeners

public <K1 extends K,V1 extends V> ExpiringMap.Builder<K1,V1> expirationListeners(List<ExpirationListener<? super K1,? super V1>> listeners)

Sets expiration listeners which will receive notifications upon each map entry's expiration.

Parameters:

listeners - to set

Throws:

NullPointerException - if listener is null

expirationPolicy

public ExpiringMap.Builder<K,V> expirationPolicy(ExpirationPolicy expirationPolicy)

Sets the map entry expiration policy.

Parameters:

expirationPolicy -

Throws:

NullPointerException - if expirationPolicy is null

variableExpiration

public ExpiringMap.Builder<K,V> variableExpiration()

Allows for map entries to have individual expirations and for expirations to be changed.