Cache2kConfiguration (cache2k API 1.3.2.Alpha API)

java.lang.Object
- org.cache2k.configuration.Cache2kConfiguration<K,V>

All Implemented Interfaces:

Serializable, ConfigurationBean, ConfigurationWithSections
```
public class Cache2kConfiguration<K,V>
extends Object
implements ConfigurationBean, ConfigurationWithSections
```
Configuration for a cache2k cache.
To create a cache, the Cache2kBuilder is used. All configuration properties are present on the builder and are documented in this place. Consequently all properties refer to the corresponding builder method.
The configuration bean is designed to be serializable. This is used for example to copy default configurations. The builder allows object references to customizations to be set. If this happens the configuration is not serializable. Such configuration is only used for immediate creation of one cache via the builder.
The configuration may contain additional beans, called configuration sections, that are used to configure extensions or sub modules.
Within the XML configuration of a cache manager different default configuration values may be specified. To get a configuration bean with the effective defaults of a specific manager do Cache2kBuilder.forUnknownTypes().manager(...).toConfiguration()

Author:

Jens Wilke

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static long EXPIRY_NOT_ETERNAL

Fields
Modifier and Type	Field and Description
`static long`	`EXPIRY_NOT_ETERNAL`

Constructor Summary

Constructors
Constructor and Description

Cache2kConfiguration()

Constructors
Constructor and Description
`Cache2kConfiguration()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`CustomizationSupplier<AdvancedCacheLoader<K,V>>`	`getAdvancedLoader()`
`CustomizationSupplier<Executor>`	`getAsyncListenerExecutor()`
`CustomizationCollection<CacheEntryOperationListener<K,V>>`	`getAsyncListeners()` A set of listeners.
`CustomizationSupplier<AsyncCacheLoader<K,V>>`	`getAsyncLoader()`
`CustomizationCollection<CacheClosedListener>`	`getCacheClosedListeners()` A set of listeners.
`long`	`getEntryCapacity()`
`CustomizationSupplier<ExceptionPropagator<K>>`	`getExceptionPropagator()`
`CustomizationSupplier<Executor>`	`getExecutor()`
`long`	`getExpireAfterWrite()`
`CustomizationSupplier<ExpiryPolicy<K,V>>`	`getExpiryPolicy()`
`CacheType<K>`	`getKeyType()`
`CustomizationCollection<CacheEntryOperationListener<K,V>>`	`getListeners()` A set of listeners.
`CustomizationSupplier<? extends FunctionalCacheLoader<K,V>>`	`getLoader()`
`CustomizationSupplier<Executor>`	`getLoaderExecutor()`
`int`	`getLoaderThreadCount()`
`long`	`getMaximumWeight()`
`long`	`getMaxRetryInterval()`
`String`	`getName()`
`CustomizationSupplier<Executor>`	`getPrefetchExecutor()`
`long`	`getResilienceDuration()`
`CustomizationSupplier<ResiliencePolicy<K,V>>`	`getResiliencePolicy()`
`long`	`getRetryInterval()`
`ConfigurationSectionContainer`	`getSections()` Mutable collection of additional configuration sections
`CustomizationSupplier<TimeReference>`	`getTimeReference()`
`CacheType<V>`	`getValueType()`
`CustomizationSupplier<Weigher>`	`getWeigher()`
`CustomizationSupplier<CacheWriter<K,V>>`	`getWriter()`
`boolean`	`hasAsyncListeners()`
`boolean`	`hasCacheClosedListeners()`
`boolean`	`hasListeners()`
`boolean`	`isBoostConcurrency()`
`boolean`	`isDisableLastModificationTime()` Deprecated.
`boolean`	`isDisableStatistics()`
`boolean`	`isEnableJmx()`
`boolean`	`isEternal()`
`boolean`	`isExternalConfigurationPresent()` An external configuration for the cache was found and is applied.
`boolean`	`isKeepDataAfterExpired()`
`boolean`	`isPermitNullValues()`
`boolean`	`isRecordRefreshedTime()`
`boolean`	`isRefreshAhead()`
`boolean`	`isSharpExpiry()`
`boolean`	`isStoreByReference()`
`boolean`	`isStrictEviction()`
`boolean`	`isSuppressExceptions()`
`static <K,V> Cache2kConfiguration<K,V>`	`of(CacheType<K> keyType, CacheType<V> valueType)` Construct a config instance setting the type parameters and returning a proper generic type.
`static <K,V> Cache2kConfiguration<K,V>`	`of(CacheType<K> keyType, Class<V> valueType)` Construct a config instance setting the type parameters and returning a proper generic type.
`static <K,V> Cache2kConfiguration<K,V>`	`of(Class<K> keyType, CacheType<V> valueType)` Construct a config instance setting the type parameters and returning a proper generic type.
`static <K,V> Cache2kConfiguration<K,V>`	`of(Class<K> keyType, Class<V> valueType)` Construct a config instance setting the type parameters and returning a proper generic type.
`void`	`setAdvancedLoader(CustomizationSupplier<AdvancedCacheLoader<K,V>> v)`
`void`	`setAsyncListenerExecutor(CustomizationSupplier<Executor> v)`
`void`	`setAsyncListeners(Collection<CustomizationSupplier<CacheEntryOperationListener<K,V>>> c)` Adds the collection of customizations to the existing list.
`void`	`setAsyncLoader(CustomizationSupplier<AsyncCacheLoader<K,V>> v)`
`void`	`setBoostConcurrency(boolean v)`
`void`	`setCacheClosedListeners(Collection<CustomizationSupplier<CacheClosedListener>> c)` Adds the collection of customizations to the existing list.
`void`	`setDisableLastModificationTime(boolean v)` Deprecated.
`void`	`setDisableStatistics(boolean v)`
`void`	`setEnableJmx(boolean v)`
`void`	`setEntryCapacity(long v)`
`void`	`setEternal(boolean v)`
`void`	`setExceptionPropagator(CustomizationSupplier<ExceptionPropagator<K>> v)`
`void`	`setExecutor(CustomizationSupplier<Executor> v)`
`void`	`setExpireAfterWrite(long millis)`
`void`	`setExpiryPolicy(CustomizationSupplier<ExpiryPolicy<K,V>> v)`
`void`	`setExternalConfigurationPresent(boolean v)`
`void`	`setKeepDataAfterExpired(boolean v)`
`void`	`setKeyType(CacheType<K> v)`
`void`	`setKeyType(Class<K> v)`
`void`	`setListeners(Collection<CustomizationSupplier<CacheEntryOperationListener<K,V>>> c)` Adds the collection of customizations to the existing list.
`void`	`setLoader(CustomizationSupplier<? extends FunctionalCacheLoader<K,V>> v)`
`void`	`setLoaderExecutor(CustomizationSupplier<Executor> v)`
`void`	`setLoaderThreadCount(int v)`
`void`	`setMaximumWeight(long v)`
`void`	`setMaxRetryInterval(long millis)`
`void`	`setName(String name)`
`void`	`setPermitNullValues(boolean v)`
`void`	`setPrefetchExecutor(CustomizationSupplier<Executor> v)`
`void`	`setRecordRefreshedTime(boolean v)`
`void`	`setRefreshAhead(boolean v)`
`void`	`setResilienceDuration(long millis)`
`void`	`setResiliencePolicy(CustomizationSupplier<ResiliencePolicy<K,V>> v)`
`void`	`setRetryInterval(long millis)`
`void`	`setSections(Collection<ConfigurationSection> c)` Adds the collection of sections to the existing list.
`void`	`setSharpExpiry(boolean v)`
`void`	`setStoreByReference(boolean v)`
`void`	`setStrictEviction(boolean v)`
`void`	`setSuppressExceptions(boolean v)`
`void`	`setTimeReference(CustomizationSupplier<TimeReference> v)`
`void`	`setValueType(CacheType<V> v)`
`void`	`setValueType(Class<V> v)`
`void`	`setWeigher(CustomizationSupplier<Weigher> v)`
`void`	`setWriter(CustomizationSupplier<CacheWriter<K,V>> v)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EXPIRY_NOT_ETERNAL
```
public static final long EXPIRY_NOT_ETERNAL
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Cache2kConfiguration
```
public Cache2kConfiguration()
```
- Method Detail
  - of
```
public static <K,V> Cache2kConfiguration<K,V> of(Class<K> keyType,
                                                 Class<V> valueType)
```
    Construct a config instance setting the type parameters and returning a proper generic type.
    
    See Also:
    
    Cache2kBuilder.keyType(Class), Cache2kBuilder.valueType(Class)
  - of
```
public static <K,V> Cache2kConfiguration<K,V> of(Class<K> keyType,
                                                 CacheType<V> valueType)
```
    Construct a config instance setting the type parameters and returning a proper generic type.
    
    See Also:
    
    Cache2kBuilder.keyType(CacheType), Cache2kBuilder.valueType(CacheType)
  - of
```
public static <K,V> Cache2kConfiguration<K,V> of(CacheType<K> keyType,
                                                 Class<V> valueType)
```
    Construct a config instance setting the type parameters and returning a proper generic type.
    
    See Also:
    
    Cache2kBuilder.keyType(Class), Cache2kBuilder.valueType(Class)
  - of
```
public static <K,V> Cache2kConfiguration<K,V> of(CacheType<K> keyType,
                                                 CacheType<V> valueType)
```
    Construct a config instance setting the type parameters and returning a proper generic type.
    
    See Also:
    
    Cache2kBuilder.keyType(CacheType), Cache2kBuilder.valueType(CacheType)
  - getName
```
public String getName()
```
    See Also:
    
    Cache2kBuilder.name(String)
  - setName
```
public void setName(String name)
```
    See Also:
    
    Cache2kBuilder.name(String)
  - getEntryCapacity
```
public long getEntryCapacity()
```
    See Also:
    
    Cache2kBuilder.entryCapacity(long)
  - setEntryCapacity
```
public void setEntryCapacity(long v)
```
  - isRefreshAhead
```
public boolean isRefreshAhead()
```
    See Also:
    
    Cache2kBuilder.refreshAhead(boolean)
  - setRefreshAhead
```
public void setRefreshAhead(boolean v)
```
    See Also:
    
    Cache2kBuilder.refreshAhead(boolean)
  - getKeyType
```
public CacheType<K> getKeyType()
```
  - setKeyType
```
public void setKeyType(Class<K> v)
```
    See Also:
    
    Cache2kBuilder.keyType(Class), for a general discussion on types
  - setKeyType
```
public void setKeyType(CacheType<K> v)
```
    See Also:
    
    Cache2kBuilder.keyType(CacheType), for a general discussion on types
  - getValueType
```
public CacheType<V> getValueType()
```
  - setValueType
```
public void setValueType(Class<V> v)
```
    See Also:
    
    Cache2kBuilder.valueType(Class), for a general discussion on types
  - setValueType
```
public void setValueType(CacheType<V> v)
```
    See Also:
    
    Cache2kBuilder.valueType(CacheType), for a general discussion on types
  - isEternal
```
public boolean isEternal()
```
  - setEternal
```
public void setEternal(boolean v)
```
    See Also:
    
    Cache2kBuilder.eternal(boolean)
  - getExpireAfterWrite
```
public long getExpireAfterWrite()
```
  - setExpireAfterWrite
```
public void setExpireAfterWrite(long millis)
```
    See Also:
    
    Cache2kBuilder.expireAfterWrite(long, java.util.concurrent.TimeUnit)
  - getRetryInterval
```
public long getRetryInterval()
```
    See Also:
    
    Cache2kBuilder.retryInterval(long, java.util.concurrent.TimeUnit)
  - setRetryInterval
```
public void setRetryInterval(long millis)
```
    See Also:
    
    Cache2kBuilder.retryInterval(long, java.util.concurrent.TimeUnit)
  - getMaxRetryInterval
```
public long getMaxRetryInterval()
```
    See Also:
    
    Cache2kBuilder.maxRetryInterval(long, java.util.concurrent.TimeUnit)
  - setMaxRetryInterval
```
public void setMaxRetryInterval(long millis)
```
    See Also:
    
    Cache2kBuilder.maxRetryInterval(long, java.util.concurrent.TimeUnit)
  - getResilienceDuration
```
public long getResilienceDuration()
```
    See Also:
    
    Cache2kBuilder.resilienceDuration(long, java.util.concurrent.TimeUnit)
  - setResilienceDuration
```
public void setResilienceDuration(long millis)
```
    See Also:
    
    Cache2kBuilder.resilienceDuration(long, java.util.concurrent.TimeUnit)
  - isKeepDataAfterExpired
```
public boolean isKeepDataAfterExpired()
```
  - getMaximumWeight
```
public long getMaximumWeight()
```
  - setMaximumWeight
```
public void setMaximumWeight(long v)
```
    See Also:
    
    Cache2kBuilder.maximumWeight(long)
  - setKeepDataAfterExpired
```
public void setKeepDataAfterExpired(boolean v)
```
    See Also:
    
    Cache2kBuilder.keepDataAfterExpired(boolean)
  - isSharpExpiry
```
public boolean isSharpExpiry()
```
  - setSharpExpiry
```
public void setSharpExpiry(boolean v)
```
    See Also:
    
    Cache2kBuilder.sharpExpiry(boolean)
  - isSuppressExceptions
```
public boolean isSuppressExceptions()
```
  - setSuppressExceptions
```
public void setSuppressExceptions(boolean v)
```
    See Also:
    
    Cache2kBuilder.suppressExceptions(boolean)
  - isExternalConfigurationPresent
```
public boolean isExternalConfigurationPresent()
```
    An external configuration for the cache was found and is applied. This is true if default values are set via the XML configuration or if there is a specific section for the cache name.
  - setExternalConfigurationPresent
```
public void setExternalConfigurationPresent(boolean v)
```
  - getSections
```
public ConfigurationSectionContainer getSections()
```
    Mutable collection of additional configuration sections
    
    Specified by:
    
    getSections in interface ConfigurationWithSections
  - setSections
```
public void setSections(Collection<ConfigurationSection> c)
```
    Adds the collection of sections to the existing list. This method is intended to improve integration with bean configuration mechanisms that use the set method and construct a set or list, like Springs' bean XML configuration.
  - getLoader
```
public CustomizationSupplier<? extends FunctionalCacheLoader<K,V>> getLoader()
```
  - setLoader
```
public void setLoader(CustomizationSupplier<? extends FunctionalCacheLoader<K,V>> v)
```
  - getAdvancedLoader
```
public CustomizationSupplier<AdvancedCacheLoader<K,V>> getAdvancedLoader()
```
  - setAdvancedLoader
```
public void setAdvancedLoader(CustomizationSupplier<AdvancedCacheLoader<K,V>> v)
```
    See Also:
    
    Cache2kBuilder.loader(AdvancedCacheLoader)
  - getAsyncLoader
```
public CustomizationSupplier<AsyncCacheLoader<K,V>> getAsyncLoader()
```
  - setAsyncLoader
```
public void setAsyncLoader(CustomizationSupplier<AsyncCacheLoader<K,V>> v)
```
  - getLoaderThreadCount
```
public int getLoaderThreadCount()
```
  - setLoaderThreadCount
```
public void setLoaderThreadCount(int v)
```
    See Also:
    
    Cache2kBuilder.loaderThreadCount(int)
  - getExpiryPolicy
```
public CustomizationSupplier<ExpiryPolicy<K,V>> getExpiryPolicy()
```
  - setExpiryPolicy
```
public void setExpiryPolicy(CustomizationSupplier<ExpiryPolicy<K,V>> v)
```
  - getWriter
```
public CustomizationSupplier<CacheWriter<K,V>> getWriter()
```
  - setWriter
```
public void setWriter(CustomizationSupplier<CacheWriter<K,V>> v)
```
    See Also:
    
    Cache2kBuilder.writer(CacheWriter)
  - isStoreByReference
```
public boolean isStoreByReference()
```
  - setStoreByReference
```
public void setStoreByReference(boolean v)
```
    See Also:
    
    Cache2kBuilder.storeByReference(boolean)
  - getExceptionPropagator
```
public CustomizationSupplier<ExceptionPropagator<K>> getExceptionPropagator()
```
  - setExceptionPropagator
```
public void setExceptionPropagator(CustomizationSupplier<ExceptionPropagator<K>> v)
```
    See Also:
    
    Cache2kBuilder.exceptionPropagator(ExceptionPropagator)
  - getListeners
```
public CustomizationCollection<CacheEntryOperationListener<K,V>> getListeners()
```
    A set of listeners. Listeners added in this collection will be executed in a synchronous mode, meaning, further processing for an entry will stall until a registered listener is executed. The expiry will be always executed asynchronously.
    A listener can be added by adding it to the collection. Duplicate (in terms of equal objects) listeners will be ignored.
    
    Returns:
    
    Mutable collection of listeners
  - hasListeners
```
public boolean hasListeners()
```
    Returns:
    
    True if listeners are added to this configuration.
  - setListeners
```
public void setListeners(Collection<CustomizationSupplier<CacheEntryOperationListener<K,V>>> c)
```
    Adds the collection of customizations to the existing list. This method is intended to improve integration with bean configuration mechanisms that use the set method and construct a set or list, like Springs' bean XML configuration.
  - getAsyncListeners
```
public CustomizationCollection<CacheEntryOperationListener<K,V>> getAsyncListeners()
```
    A set of listeners. A listener can be added by adding it to the collection. Duplicate (in terms of equal objects) listeners will be ignored.
    
    Returns:
    
    Mutable collection of listeners
  - hasAsyncListeners
```
public boolean hasAsyncListeners()
```
    Returns:
    
    True if listeners are added to this configuration.
  - setAsyncListeners
```
public void setAsyncListeners(Collection<CustomizationSupplier<CacheEntryOperationListener<K,V>>> c)
```
    Adds the collection of customizations to the existing list. This method is intended to improve integration with bean configuration mechanisms that use the set method and construct a set or list, like Springs' bean XML configuration.
  - getCacheClosedListeners
```
public CustomizationCollection<CacheClosedListener> getCacheClosedListeners()
```
    A set of listeners. A listener can be added by adding it to the collection. Duplicate (in terms of equal objects) listeners will be ignored.
    
    Returns:
    
    Mutable collection of listeners
    
    Since:
    
    1.0.2
  - hasCacheClosedListeners
```
public boolean hasCacheClosedListeners()
```
    Returns:
    
    True if listeners are added to this configuration.
  - setCacheClosedListeners
```
public void setCacheClosedListeners(Collection<CustomizationSupplier<CacheClosedListener>> c)
```
    Adds the collection of customizations to the existing list. This method is intended to improve integration with bean configuration mechanisms that use the set method and construct a set or list, like Springs' bean XML configuration.
  - getResiliencePolicy
```
public CustomizationSupplier<ResiliencePolicy<K,V>> getResiliencePolicy()
```
  - setResiliencePolicy
```
public void setResiliencePolicy(CustomizationSupplier<ResiliencePolicy<K,V>> v)
```
    See Also:
    
    Cache2kBuilder.resiliencePolicy(org.cache2k.integration.ResiliencePolicy<K, V>)
  - isStrictEviction
```
public boolean isStrictEviction()
```
  - setStrictEviction
```
public void setStrictEviction(boolean v)
```
    See Also:
    
    Cache2kBuilder.strictEviction(boolean)
  - isPermitNullValues
```
public boolean isPermitNullValues()
```
  - setPermitNullValues
```
public void setPermitNullValues(boolean v)
```
    See Also:
    
    Cache2kBuilder.permitNullValues(boolean)
  - isDisableStatistics
```
public boolean isDisableStatistics()
```
  - setDisableStatistics
```
public void setDisableStatistics(boolean v)
```
    See Also:
    
    Cache2kBuilder.disableStatistics(boolean)
  - getLoaderExecutor
```
public CustomizationSupplier<Executor> getLoaderExecutor()
```
  - isDisableLastModificationTime
```
@Deprecated
public boolean isDisableLastModificationTime()
```
    Deprecated.
  - setDisableLastModificationTime
```
@Deprecated
public void setDisableLastModificationTime(boolean v)
```
    Deprecated.
    
    See Also:
    
    Cache2kBuilder.disableLastModificationTime(boolean)
  - isRecordRefreshedTime
```
public boolean isRecordRefreshedTime()
```
  - setRecordRefreshedTime
```
public void setRecordRefreshedTime(boolean v)
```
    See Also:
    
    Cache2kBuilder.recordRefreshedTime(boolean)
  - setLoaderExecutor
```
public void setLoaderExecutor(CustomizationSupplier<Executor> v)
```
    See Also:
    
    Cache2kBuilder.loaderExecutor(Executor)
  - getPrefetchExecutor
```
public CustomizationSupplier<Executor> getPrefetchExecutor()
```
  - setPrefetchExecutor
```
public void setPrefetchExecutor(CustomizationSupplier<Executor> v)
```
    See Also:
    
    Cache2kBuilder.prefetchExecutor(Executor)
  - getExecutor
```
public CustomizationSupplier<Executor> getExecutor()
```
  - setExecutor
```
public void setExecutor(CustomizationSupplier<Executor> v)
```
    See Also:
    
    Cache2kBuilder.executor(Executor)
  - getAsyncListenerExecutor
```
public CustomizationSupplier<Executor> getAsyncListenerExecutor()
```
  - setAsyncListenerExecutor
```
public void setAsyncListenerExecutor(CustomizationSupplier<Executor> v)
```
    See Also:
    
    Cache2kBuilder.asyncListenerExecutor(Executor)
  - getTimeReference
```
public CustomizationSupplier<TimeReference> getTimeReference()
```
  - setTimeReference
```
public void setTimeReference(CustomizationSupplier<TimeReference> v)
```
    See Also:
    
    Cache2kBuilder.timeReference(TimeReference)
  - getWeigher
```
public CustomizationSupplier<Weigher> getWeigher()
```
  - setWeigher
```
public void setWeigher(CustomizationSupplier<Weigher> v)
```
    See Also:
    
    Cache2kBuilder.weigher(Weigher)
  - isBoostConcurrency
```
public boolean isBoostConcurrency()
```
  - setBoostConcurrency
```
public void setBoostConcurrency(boolean v)
```
    See Also:
    
    Cache2kBuilder.boostConcurrency(boolean)
  - isEnableJmx
```
public boolean isEnableJmx()
```
  - setEnableJmx
```
public void setEnableJmx(boolean v)
```
    See Also:
    
    Cache2kBuilder.enableJmx(boolean)

Class Cache2kConfiguration<K,V>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EXPIRY_NOT_ETERNAL

Constructor Detail

Cache2kConfiguration

Method Detail

of

of

of

of

getName

setName

getEntryCapacity

setEntryCapacity

isRefreshAhead

setRefreshAhead

getKeyType

setKeyType

setKeyType

getValueType

setValueType

setValueType

isEternal

setEternal

getExpireAfterWrite

setExpireAfterWrite

getRetryInterval

setRetryInterval

getMaxRetryInterval

setMaxRetryInterval

getResilienceDuration

setResilienceDuration

isKeepDataAfterExpired

getMaximumWeight

setMaximumWeight

setKeepDataAfterExpired

isSharpExpiry

setSharpExpiry

isSuppressExceptions

setSuppressExceptions

isExternalConfigurationPresent

setExternalConfigurationPresent

getSections

setSections

getLoader

setLoader

getAdvancedLoader

setAdvancedLoader

getAsyncLoader

setAsyncLoader

getLoaderThreadCount

setLoaderThreadCount

getExpiryPolicy

setExpiryPolicy

getWriter

setWriter

isStoreByReference

setStoreByReference

getExceptionPropagator

setExceptionPropagator

getListeners

hasListeners

setListeners

getAsyncListeners

hasAsyncListeners

setAsyncListeners

getCacheClosedListeners

hasCacheClosedListeners

setCacheClosedListeners

getResiliencePolicy

setResiliencePolicy

isStrictEviction

setStrictEviction

isPermitNullValues

setPermitNullValues

isDisableStatistics