org.gridgain.grid.cache

Enum GridCacheMode

java.lang.Object

java.lang.Enum<GridCacheMode>

org.gridgain.grid.cache.GridCacheMode

All Implemented Interfaces:

Serializable, Comparable<GridCacheMode>

public enum GridCacheMode
extends Enum<GridCacheMode>

Enumeration of all supported caching modes. Cache mode is specified in GridCacheConfiguration and cannot be changed after cache has started.

Enum Constant Summary

Enum Constants

Enum Constant and Description
LOCAL Specifies local-only cache behaviour.
PARTITIONED Specifies partitioned cache behaviour.
REPLICATED Specifies fully replicated cache behavior.

Method Summary

Methods

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

LOCAL

public static final GridCacheMode LOCAL

Specifies local-only cache behaviour. In this mode caches residing on different grid nodes will not know about each other.

Other than distribution, local caches still have all the caching features, such as eviction, expiration, swapping, querying, etc... This mode is very useful when caching read-only data or data that automatically expires at a certain interval and then automatically reloaded from persistence store.

REPLICATED

public static final GridCacheMode REPLICATED

Specifies fully replicated cache behavior. In this mode all the keys are distributed to all participating nodes. User still has affinity control over subset of nodes for any given key via GridCacheAffinityFunction configuration.

PARTITIONED

public static final GridCacheMode PARTITIONED

Specifies partitioned cache behaviour. In this mode the overall key set will be divided into partitions and all partitions will be split equally between participating nodes. User has affinity control over key assignment via GridCacheAffinityFunction configuration.

Note that partitioned cache is always fronted by local 'near' cache which stores most recent data. You can configure the size of near cache via GridCacheConfiguration.getNearEvictionPolicy() configuration property.

Method Detail

values

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

Returns:

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

valueOf

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

Efficiently gets enumerated value from its ordinal.

Parameters:

ord - Ordinal value.

Returns:

Enumerated value or null if ordinal out of range.