org.apache.ignite.cache

Enum CacheAtomicityMode

java.lang.Object

java.lang.Enum<CacheAtomicityMode>

org.apache.ignite.cache.CacheAtomicityMode

All Implemented Interfaces:

Serializable, Comparable<CacheAtomicityMode>

public enum CacheAtomicityMode
extends Enum<CacheAtomicityMode>

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 CacheConfiguration.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 CacheAtomicityMode	fromOrdinal(int ord) Efficiently gets enumerated value from its ordinal.
static CacheAtomicityMode	valueOf(String name) Returns the enum constant of this type with the specified name.
static CacheAtomicityMode[]	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 CacheAtomicityMode TRANSACTIONAL

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

ATOMIC

public static final CacheAtomicityMode 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 CachePartialUpdateCheckedException 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.

Method Detail

values

public static CacheAtomicityMode[] 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 (CacheAtomicityMode c : CacheAtomicityMode.values())
    System.out.println(c);

Returns:

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

valueOf

public static CacheAtomicityMode 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 CacheAtomicityMode fromOrdinal(int ord)

Efficiently gets enumerated value from its ordinal.

Parameters:

ord - Ordinal value.

Returns:

Enumerated value or null if ordinal out of range.