org.gridgain.grid.cache

Enum GridCacheAtomicityMode

java.lang.Object

java.lang.Enum<GridCacheAtomicityMode>

org.gridgain.grid.cache.GridCacheAtomicityMode

All Implemented Interfaces:

Serializable, Comparable<GridCacheAtomicityMode>

public enum GridCacheAtomicityMode
extends Enum<GridCacheAtomicityMode>

Cache atomicity mode controls whether cache should maintain fully transactional semantics or more light-weight atomic behavior. It is recommended that ATOMIC mode is used whenever transactions and explicit locking are not needed. Note that in ATOMIC mode cache will still maintain full data consistency across all cache nodes.

Cache atomicity may be set via GridCacheConfiguration.getAtomicityMode() configuration property.

Enum Constant Summary

Enum Constants

Enum Constant and Description
ATOMIC Specifies atomic-only cache behaviour.
TRANSACTIONAL Specified fully ACID-compliant transactional cache behavior.

Method Summary

Methods

Modifier and Type	Method and Description
static GridCacheAtomicityMode	fromOrdinal(int ord) Efficiently gets enumerated value from its ordinal.
static GridCacheAtomicityMode	valueOf(String name) Returns the enum constant of this type with the specified name.
static GridCacheAtomicityMode[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

TRANSACTIONAL

public static final GridCacheAtomicityMode TRANSACTIONAL

Specified fully ACID-compliant transactional cache behavior. See GridCacheTx for more information about transactions.

This mode is currently the default cache atomicity mode. However, cache atomicity mode will be changed to ATOMIC starting from version 5.2, so it is recommended that desired atomicity mode is explicitly configured instead of relying on default value.

ATOMIC

public static final GridCacheAtomicityMode ATOMIC

Specifies atomic-only cache behaviour. In this mode distributed transactions and distributed locking are not supported. Disabling transactions and locking allows to achieve much higher performance and throughput ratios.

In addition to transactions and locking, one of the main differences in ATOMIC mode is that bulk writes, such as putAll(...), removeAll(...), and transformAll(...) methods, become simple batch operations which can partially fail. In case of partial failure GridCachePartialUpdateException will be thrown which will contain a list of keys for which the update failed. It is recommended that bulk writes are used whenever multiple keys need to be inserted or updated in cache, as they reduce number of network trips and provide better performance.

Note that even without locking and transactions, ATOMIC mode still provides full consistency guarantees across all cache nodes.

Also note that all data modifications in ATOMIC mode are guaranteed to be atomic and consistent with writes to the underlying persistent store, if one is configured.

This mode is currently implemented for GridCacheMode.PARTITIONED caches only.

Method Detail

values

public static GridCacheAtomicityMode[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (GridCacheAtomicityMode c : GridCacheAtomicityMode.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static GridCacheAtomicityMode valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

fromOrdinal

@Nullable
public static GridCacheAtomicityMode fromOrdinal(int ord)

Efficiently gets enumerated value from its ordinal.

Parameters:

ord - Ordinal value.

Returns:

Enumerated value or null if ordinal out of range.