Класс AtomicReference<V>

public class AtomicReference<V>
extends Object
implements Serializable

Конструкторы

AtomicReference

public AtomicReference(V initialValue)

Создаёт новый AtomicReference с заданным начальным значением.

Параметры:

initialValue - начальное значение

AtomicReference

public AtomicReference()

Создаёт новый AtomicReference с начальным значением null.

Методы

get

public final V get()

Получает текущее значение.

Возвращает:

текущее значение

set

public final void set(V newValue)

Устанавливает заданное значение.

Параметры:

newValue - новое значение

lazySet

public final void lazySet(V newValue)

В конечном итоге устанавливает заданное значение.

Параметры:

newValue - новое значение

С тех пор:

1.6

compareAndSet

public final boolean compareAndSet(V expect,
                                   V update)

Атомарно устанавливает значение на заданное обновлённое значение, если текущее значение == ожидаемое значение.

Параметры:

expect - ожидаемое значение

update - новое значение

Возвращает:

true если успешно. Возвращение false указывает, что фактическое значение не было равно ожидаемому значению.

weakCompareAndSet

public final boolean weakCompareAndSet(V expect,
                                       V update)

Параметры:

expect - ожидаемое значение

update - новое значение

Возвращает:

true если успешно

getAndSet

public final V getAndSet(V newValue)

Атомарно устанавливает заданное значение и возвращает старое значение.

Параметры:

newValue - новое значение

Возвращает:

предыдущее значение

getAndUpdate

public final V getAndUpdate(UnaryOperator<V> updateFunction)

Атомарно обновляет текущее значение результатом применения заданной функции, возвращая предыдущее значение. Функция не должна иметь побочных эффектов, так как она может быть повторно применена, когда попытки обновлений завершаются неудачей из-за конкуренции между потоками.

Параметры:

updateFunction - функция без побочных эффектов

Возвращает:

предыдущее значение

С тех пор:

1.8

updateAndGet

public final V updateAndGet(UnaryOperator<V> updateFunction)

Атомарно обновляет текущее значение результатом применения заданной функции, возвращая обновлённое значение. Функция не должна иметь побочных эффектов, так как она может быть повторно применена, когда попытки обновлений завершаются неудачей из-за конкуренции между потоками.

Параметры:

updateFunction - функция без побочных эффектов

Возвращает:

обновлённое значение

С тех пор:

1.8

getAndAccumulate

public final V getAndAccumulate(V x,
                                BinaryOperator<V> accumulatorFunction)

Атомарно обновляет текущее значение результатом применения заданной функции к текущему и заданному значениям, возвращая предыдущее значение. Функция не должна иметь побочных эффектов, так как она может быть повторно применена, когда попытки обновлений завершаются неудачей из-за конкуренции между потоками. Функция применяется к текущему значению в качестве первого аргумента и заданному обновлению в качестве второго аргумента.

Параметры:

x - значение обновления

accumulatorFunction - функция без побочных эффектов от двух аргументов

Возвращает:

предыдущее значение

С тех пор:

1.8

accumulateAndGet

public final V accumulateAndGet(V x,
                                BinaryOperator<V> accumulatorFunction)

Атомарно обновляет текущее значение результатом применения заданной функции к текущему и заданному значениям, возвращая обновлённое значение. Функция не должна иметь побочных эффектов, так как она может быть повторно применена, когда попытки обновлений завершаются неудачей из-за конкуренции между потоками. Функция применяется к текущему значению в качестве первого аргумента и заданному обновлению в качестве второго аргумента.

Параметры:

x - значение обновления

accumulatorFunction - функция без побочных эффектов от двух аргументов

Возвращает:

обновлённое значение

С тех пор:

1.8

toString

public String toString()

Возвращает строковое представление текущего значения.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление текущего значения