javax.cache.configuration

Class MutableConfiguration<K,V>

java.lang.Object

javax.cache.configuration.Configuration<K,V>

javax.cache.configuration.MutableConfiguration<K,V>

Type Parameters:

K - the type of keys maintained the cache

V - the type of cached values

All Implemented Interfaces:

Serializable

public class MutableConfiguration<K,V>
extends Configuration<K,V>

A simple mutable implementation of a Configuration.

Since:

1.0

Author:

Brian Oliver, Greg Luck

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Factory<CacheLoader<K,V>>	cacheLoaderFactory The Factory for the CacheLoader.
protected Factory<CacheWriter<? super K,? super V>>	cacheWriterFactory The Factory for the CacheWriter.
protected Factory<ExpiryPolicy<? super K>>	expiryPolicyFactory The Factory for the ExpiryPolicy.
protected boolean	isManagementEnabled Whether management is enabled
protected boolean	isReadThrough A flag indicating if "read-through" mode is required.
protected boolean	isStatisticsEnabled A flag indicating if statistics gathering is enabled.
protected boolean	isStoreByValue A flag indicating if the cache will be store-by-value or store-by-reference.
protected boolean	isTransactionsEnabled A flag indicating if the cache will use transactions.
protected boolean	isWriteThrough A flag indicating if "write-through" mode is required.
protected Class<K>	keyType The type of keys for Caches configured with this Configuration.
protected ArrayList<CacheEntryListenerConfiguration<K,V>>	listenerConfigurations The CacheEntryListenerConfigurations for the Configuration.
static long	serialVersionUID The serialVersionUID required for Serializable.
protected IsolationLevel	txnIsolationLevel The transaction IsolationLevel.
protected Mode	txnMode The transaction Mode.
protected Class<V>	valueType The type of values for Caches configured with this Configuration.

Constructor Summary

Constructors

Constructor and Description
MutableConfiguration() Constructs a default MutableConfiguration.
MutableConfiguration(Configuration<K,V> configuration) Constructs a MutableConfiguration based on another Configuration.

Method Summary

Methods

Modifier and Type	Method and Description
MutableConfiguration<K,V>	addCacheEntryListenerConfiguration(CacheEntryListenerConfiguration<K,V> cacheEntryListenerConfiguration) Add a configuration for a CacheEntryListener.
boolean	equals(Object object)
List<CacheEntryListenerConfiguration<K,V>>	getCacheEntryListenerConfigurations() Obtains the CacheEntryListenerConfigurations for CacheEntryListeners to be configured on a Cache.
Factory<CacheLoader<K,V>>	getCacheLoaderFactory() Gets the Factory for the CacheLoader, if any.
Factory<CacheWriter<? super K,? super V>>	getCacheWriterFactory() Gets the Factory for the CacheWriter, if any.
Factory<ExpiryPolicy<? super K>>	getExpiryPolicyFactory() Gets the Factory for the ExpiryPolicy to be used for caches.
Class<K>	getKeyType() Determines the required type of keys for Caches configured with this Configuration.
IsolationLevel	getTransactionIsolationLevel() Gets the transaction isolation level.
Mode	getTransactionMode() Gets the transaction mode.
Class<V>	getValueType() Determines the required type of values for Caches configured with this Configuration.
int	hashCode()
boolean	isManagementEnabled() Checks whether management is enabled on this cache.
boolean	isReadThrough() Determines if a Cache should operate in read-through mode.
boolean	isStatisticsEnabled() Checks whether statistics collection is enabled in this cache.
boolean	isStoreByValue() Whether storeByValue (true) or storeByReference (false).
boolean	isTransactionsEnabled() Checks whether transactions are enabled for this cache.
boolean	isWriteThrough() Determines if a Cache should operate in write-through mode.
MutableConfiguration<K,V>	setCacheLoaderFactory(Factory<? extends CacheLoader<K,V>> factory) Set the CacheLoader factory.
MutableConfiguration<K,V>	setCacheWriterFactory(Factory<? extends CacheWriter<? super K,? super V>> factory) Set the CacheWriter factory.
MutableConfiguration<K,V>	setExpiryPolicyFactory(Factory<? extends ExpiryPolicy<? super K>> factory) Set the Factory for the ExpiryPolicy.
MutableConfiguration<K,V>	setManagementEnabled(boolean enabled) Sets whether management is enabled on a cache.
MutableConfiguration<K,V>	setReadThrough(boolean isReadThrough) Set if read-through caching should be used.
MutableConfiguration<K,V>	setStatisticsEnabled(boolean enabled) Sets whether statistics gathering is enabled on a cache.
MutableConfiguration<K,V>	setStoreByValue(boolean isStoreByValue) Set if a configured cache should use store-by-value or store-by-reference semantics.
MutableConfiguration<K,V>	setTransactions(IsolationLevel level, Mode mode) Set the Transaction IsolationLevel and Mode, which also sets isTransactionsEnabled() to true.
MutableConfiguration<K,V>	setTypes(Class<K> keyType, Class<V> valueType) Sets the expected type of keys and values for a Cache configured with this Configuration.
MutableConfiguration<K,V>	setWriteThrough(boolean isWriteThrough) Set if write-through caching should be used.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

public static final long serialVersionUID

The serialVersionUID required for Serializable.

See Also:

Constant Field Values

keyType

protected Class<K> keyType

The type of keys for Caches configured with this Configuration.

valueType

protected Class<V> valueType

The type of values for Caches configured with this Configuration.

listenerConfigurations

protected ArrayList<CacheEntryListenerConfiguration<K,V>> listenerConfigurations

The CacheEntryListenerConfigurations for the Configuration.

cacheLoaderFactory

protected Factory<CacheLoader<K,V>> cacheLoaderFactory

The Factory for the CacheLoader.

cacheWriterFactory

protected Factory<CacheWriter<? super K,? super V>> cacheWriterFactory

The Factory for the CacheWriter.

expiryPolicyFactory

protected Factory<ExpiryPolicy<? super K>> expiryPolicyFactory

The Factory for the ExpiryPolicy.

isReadThrough

protected boolean isReadThrough

A flag indicating if "read-through" mode is required.

isWriteThrough

protected boolean isWriteThrough

A flag indicating if "write-through" mode is required.

isStatisticsEnabled

protected boolean isStatisticsEnabled

A flag indicating if statistics gathering is enabled.

isStoreByValue

protected boolean isStoreByValue

A flag indicating if the cache will be store-by-value or store-by-reference.

isTransactionsEnabled

protected boolean isTransactionsEnabled

A flag indicating if the cache will use transactions.

txnIsolationLevel

protected IsolationLevel txnIsolationLevel

The transaction IsolationLevel.

txnMode

protected Mode txnMode

The transaction Mode.

isManagementEnabled

protected boolean isManagementEnabled

Whether management is enabled

Constructor Detail

MutableConfiguration

public MutableConfiguration()

Constructs a default MutableConfiguration.

MutableConfiguration

public MutableConfiguration(Configuration<K,V> configuration)

Constructs a MutableConfiguration based on another Configuration.

Parameters:

configuration - the Configuration

Method Detail

getKeyType

public Class<K> getKeyType()

Determines the required type of keys for Caches configured with this Configuration.

Specified by:

getKeyType in class Configuration<K,V>

Returns:

the key type or Object.class if the type is undefined

getValueType

public Class<V> getValueType()

Determines the required type of values for Caches configured with this Configuration.

Specified by:

getValueType in class Configuration<K,V>

Returns:

the value type or Object.class if the type is undefined

setTypes

public MutableConfiguration<K,V> setTypes(Class<K> keyType,
                                 Class<V> valueType)

Sets the expected type of keys and values for a Cache configured with this Configuration. Setting both to Object.class means type-safety checks are not required.

Parameters:

keyType - the expected key type

valueType - the expected value type

Returns:

the MutableConfiguration to permit fluent-style method calls

Throws:

NullPointerException - should the key or value type be null

getCacheEntryListenerConfigurations

public List<CacheEntryListenerConfiguration<K,V>> getCacheEntryListenerConfigurations()

Obtains the CacheEntryListenerConfigurations for CacheEntryListeners to be configured on a Cache.

Specified by:

getCacheEntryListenerConfigurations in class Configuration<K,V>

Returns:

an Iterable over the CacheEntryListenerConfigurations

addCacheEntryListenerConfiguration

public MutableConfiguration<K,V> addCacheEntryListenerConfiguration(CacheEntryListenerConfiguration<K,V> cacheEntryListenerConfiguration)

Add a configuration for a CacheEntryListener.

Parameters:

cacheEntryListenerConfiguration - the CacheEntryListenerConfiguration

Returns:

the MutableConfiguration to permit fluent-style method calls

Throws:

IllegalArgumentException - is the same CacheEntryListenerConfiguration is used more than once

getCacheLoaderFactory

public Factory<CacheLoader<K,V>> getCacheLoaderFactory()

Gets the Factory for the CacheLoader, if any.

A CacheLoader should be configured for "Read Through" caches to load values when a cache miss occurs using either the Cache.get(Object) and/or Cache.getAll(java.util.Set) methods.

The default value is null.

Specified by:

getCacheLoaderFactory in class Configuration<K,V>

Returns:

the Factory for the CacheLoader or null if none has been set.

setCacheLoaderFactory

public MutableConfiguration<K,V> setCacheLoaderFactory(Factory<? extends CacheLoader<K,V>> factory)

Set the CacheLoader factory.

Parameters:

factory - the CacheLoader Factory

Returns:

the MutableConfiguration to permit fluent-style method calls

getCacheWriterFactory

public Factory<CacheWriter<? super K,? super V>> getCacheWriterFactory()

Gets the Factory for the CacheWriter, if any.

The default value is null.

Specified by:

getCacheWriterFactory in class Configuration<K,V>

Returns:

the Factory for the CacheWriter or null if none has been set.

setCacheWriterFactory

public MutableConfiguration<K,V> setCacheWriterFactory(Factory<? extends CacheWriter<? super K,? super V>> factory)

Set the CacheWriter factory.

Parameters:

factory - the CacheWriter Factory

Returns:

the MutableConfiguration to permit fluent-style method calls

getExpiryPolicyFactory

public Factory<ExpiryPolicy<? super K>> getExpiryPolicyFactory()

Gets the Factory for the ExpiryPolicy to be used for caches.

The default value is a Factory that will produce a EternalExpiryPolicy instance.

Specified by:

getExpiryPolicyFactory in class Configuration<K,V>

Returns:

the Factory for ExpiryPolicy (must not be null)

setExpiryPolicyFactory

public MutableConfiguration<K,V> setExpiryPolicyFactory(Factory<? extends ExpiryPolicy<? super K>> factory)

Set the Factory for the ExpiryPolicy. If null is specified the default ExpiryPolicy is used.

Parameters:

factory - the ExpiryPolicy Factory

Returns:

the MutableConfiguration to permit fluent-style method calls

getTransactionIsolationLevel

public IsolationLevel getTransactionIsolationLevel()

Gets the transaction isolation level.

The default value is IsolationLevel.NONE.

Specified by:

getTransactionIsolationLevel in class Configuration<K,V>

Returns:

the isolation level.

setTransactions

public MutableConfiguration<K,V> setTransactions(IsolationLevel level,
                                        Mode mode)

Set the Transaction IsolationLevel and Mode, which also sets isTransactionsEnabled() to true.

Parameters:

level - the IsolationLevel

mode - the Mode

Returns:

the MutableConfiguration to permit fluent-style method calls

getTransactionMode

public Mode getTransactionMode()

Gets the transaction mode.

The default value is Mode.NONE.

Specified by:

getTransactionMode in class Configuration<K,V>

Returns:

the mode of the cache.

isReadThrough

public boolean isReadThrough()

Determines if a Cache should operate in read-through mode.

When in "read-through" mode, cache misses that occur due to cache entries not existing as a result of performing a "get" will appropriately cause the configured CacheLoader to be invoked.

The default value is false.

Specified by:

isReadThrough in class Configuration<K,V>

Returns:

true when a Cache is in "read-through" mode.

See Also:

Configuration.getCacheLoaderFactory()

setReadThrough

public MutableConfiguration<K,V> setReadThrough(boolean isReadThrough)

Set if read-through caching should be used.

It is an invalid configuration to set this to true without specifying a CacheLoader Factory.

Parameters:

isReadThrough - true if read-through is required

Returns:

the MutableConfiguration to permit fluent-style method calls

isWriteThrough

public boolean isWriteThrough()

Determines if a Cache should operate in write-through mode.

When in "write-through" mode, cache updates that occur as a result of performing "put" operations called via one of Cache.put(Object, Object), Cache.getAndRemove(Object), Cache.removeAll(), Cache.getAndPut(Object, Object) Cache.getAndRemove(Object), Cache.getAndReplace(Object, Object), Cache.invoke(Object, javax.cache.processor.EntryProcessor, Object...), Cache.invokeAll(java.util.Set, javax.cache.processor.EntryProcessor, Object...) will appropriately cause the configured CacheWriter to be invoked.

The default value is false.

Specified by:

isWriteThrough in class Configuration<K,V>

Returns:

true when a Cache is in "write-through" mode.

See Also:

Configuration.getCacheWriterFactory()

setWriteThrough

public MutableConfiguration<K,V> setWriteThrough(boolean isWriteThrough)

Set if write-through caching should be used.

It is an invalid configuration to set this to true without specifying a CacheWriter Factory.

Parameters:

isWriteThrough - true if write-through is required

Returns:

the MutableConfiguration to permit fluent-style method calls

isStoreByValue

public boolean isStoreByValue()

Whether storeByValue (true) or storeByReference (false). When true, both keys and values are stored by value.

When false, both keys and values are stored by reference. Caches stored by reference are capable of mutation by any threads holding the reference. The effects are:

• if the key is mutated, then the key may not be retrievable or removable
• if the value is mutated, then all threads in the JVM can potentially observe those mutations, subject to the normal Java Memory Model rules.

Storage by reference only applies to the local heap. If an entry is moved off heap it will need to be transformed into a representation. Any mutations that occur after transformation may not be reflected in the cache.

Additionally Store-By-Reference is only supported for non-transactional caches. Attempts to configure a cache using both transactions and Store-By-Reference will result in an in a CacheException.

When a cache is storeByValue, any mutation to the key or value does not affect the key of value stored in the cache.

The default value is true.

Specified by:

isStoreByValue in class Configuration<K,V>

Returns:

true if the cache is store by value

setStoreByValue

public MutableConfiguration<K,V> setStoreByValue(boolean isStoreByValue)

Set if a configured cache should use store-by-value or store-by-reference semantics.

Parameters:

isStoreByValue - true if store-by-value is required, false for store-by-reference

Returns:

the MutableConfiguration to permit fluent-style method calls

isStatisticsEnabled

public boolean isStatisticsEnabled()

Checks whether statistics collection is enabled in this cache.

The default value is false.

Specified by:

isStatisticsEnabled in class Configuration<K,V>

Returns:

true if statistics collection is enabled

setStatisticsEnabled

public MutableConfiguration<K,V> setStatisticsEnabled(boolean enabled)

Sets whether statistics gathering is enabled on a cache.

Statistics may be enabled or disabled at runtime via CacheManager.enableStatistics(String, boolean).

Parameters:

enabled - true to enable statistics, false to disable.

Returns:

the MutableConfiguration to permit fluent-style method calls

isManagementEnabled

public boolean isManagementEnabled()

Checks whether management is enabled on this cache.

The default value is false.

Specified by:

isManagementEnabled in class Configuration<K,V>

Returns:

true if management is enabled

setManagementEnabled

public MutableConfiguration<K,V> setManagementEnabled(boolean enabled)

Sets whether management is enabled on a cache.

Management may be enabled or disabled at runtime via CacheManager.enableManagement(String, boolean).

Parameters:

enabled - true to enable statistics, false to disable.

Returns:

the MutableConfiguration to permit fluent-style method calls

isTransactionsEnabled

public boolean isTransactionsEnabled()

Checks whether transactions are enabled for this cache.

Note that in a transactional cache, entries being mutated within a transaction cannot be expired by the cache.

The default value is false.

Specified by:

isTransactionsEnabled in class Configuration<K,V>

Returns:

true if transaction are enabled

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object object)

Overrides:

equals in class Object