Класс AtomicReferenceArray<E>

public class AtomicReferenceArray<E>
extends Object
implements Serializable

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

AtomicReferenceArray

public AtomicReferenceArray(int length)

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

Параметры:

length - длина массива

AtomicReferenceArray

public AtomicReferenceArray(E[] array)

Создаёт новый AtomicReferenceArray с длиной, равной длине заданного массива, и всеми элементами, скопированными из заданного массива.

Параметры:

array - массив для копирования элементов

Исключения:

NullPointerException - если массив null

Методы

length

public final int length()

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

Возвращает:

длину массива

get

public final E get(int i)

Получает текущее значение в позиции i.

Параметры:

i - индекс

Возвращает:

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

set

public final void set(int i,
                      E newValue)

Устанавливает элемент в позиции i в заданное значение.

Параметры:

i - индекс

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

lazySet

public final void lazySet(int i,
                          E newValue)

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

Параметры:

i - индекс

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

С:

1.6

getAndSet

public final E getAndSet(int i,
                         E newValue)

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

Параметры:

i - индекс

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

Возвращает:

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

compareAndSet

public final boolean compareAndSet(int i,
                                   E expect,
                                   E update)

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

Параметры:

i - индекс

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

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

Возвращает:

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

weakCompareAndSet

public final boolean weakCompareAndSet(int i,
                                       E expect,
                                       E update)

Параметры:

i - индекс

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

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

Возвращает:

true в случае успеха

getAndUpdate

public final E getAndUpdate(int i,
                            UnaryOperator<E> updateFunction)

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

Параметры:

i - индекс

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

Возвращает:

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

С:

1.8

updateAndGet

public final E updateAndGet(int i,
                            UnaryOperator<E> updateFunction)

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

Параметры:

i - индекс

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

Возвращает:

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

С:

1.8

getAndAccumulate

public final E getAndAccumulate(int i,
                                E x,
                                BinaryOperator<E> accumulatorFunction)

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

Параметры:

i - индекс

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

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

Возвращает:

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

С:

1.8

accumulateAndGet

public final E accumulateAndGet(int i,
                                E x,
                                BinaryOperator<E> accumulatorFunction)

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

Параметры:

i - индекс

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

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

Возвращает:

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

С:

1.8

toString

public String toString()

Возвращает строковое представление текущих значений массива.

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

toString в классе Object

Возвращает:

строковое представление текущих значений массива