org.gridgain.grid.cache.datastructures

Interface GridCacheAtomicReference<T>

All Known Subinterfaces:

GridCacheAtomicReferenceEx<T>

All Known Implementing Classes:

GridCacheAtomicReferenceImpl

public interface GridCacheAtomicReference<T>

This interface provides a rich API for working with distributed atomic reference.

Functionality

Distributed atomic reference includes the following main functionality:

• Method get() synchronously gets current value of an atomic reference.
• Method set(Object) synchronously and unconditionally sets the value in the an atomic reference.
• Methods compareAndSet(...) synchronously and conditionally set the value in the an atomic reference.

All previously described methods have asynchronous analogs.

• Method name() gets name of atomic reference.

Creating Distributed Atomic Reference

Instance of distributed atomic reference can be created by calling the following method:

• GridCacheDataStructures.atomicReference(String, Object, boolean)

See Also:

GridCacheDataStructures.atomicReference(String, Object, boolean), GridCacheDataStructures.removeAtomicReference(String)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	compareAndSet(T expVal, T newVal) Conditionally sets the new value.
T	get() Gets current value of an atomic reference.
String	name() Name of atomic reference.
boolean	removed() Gets status of atomic.
void	set(T val) Unconditionally sets the value.

Method Detail

name

String name()

Name of atomic reference.

Returns:

Name of an atomic reference.

get

T get()
      throws GridException

Gets current value of an atomic reference.

Returns:

current value of an atomic reference.

Throws:

GridException - If operation failed.

set

void set(T val)
         throws GridException

Unconditionally sets the value.

Parameters:

val - Value.

Throws:

GridException - If operation failed.

compareAndSet

boolean compareAndSet(T expVal,
                    T newVal)
                      throws GridException

Conditionally sets the new value. That will be set if expVal is equal to current value respectively.

Parameters:

expVal - Expected value.

newVal - New value.

Returns:

Result of operation execution. If true than value have been updated.

Throws:

GridException - If operation failed.

removed

boolean removed()

Gets status of atomic.

Returns:

true if an atomic reference was removed from cache, false otherwise.