Класс AtomicReferenceArray<E>

Type Parameters:
E - Базовый класс элементов, хранящихся в этом массиве
Все реализованные интерфейсы:
Serializable
public class AtomicReferenceArray<E>
extends Object
implements Serializable

Массив ссылок на объекты, элементы которого могут быть обновлены атомарно. Обратитесь к спецификации VarHandle, чтобы узнать о свойствах атомарных операций доступа.

С момента:
1.5
См. также:
Сериализованная форма

Краткое описание конструкторов

Конструктор Описание
AtomicReferenceArray​(int length)

Создаёт новый AtomicReferenceArray заданной длины, со всеми элементами, первоначально равными null.
AtomicReferenceArray​(E[] array)

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

Краткое описание методов

Модификатор и тип Метод Описание
E accumulateAndGet​(int i, E x, BinaryOperator<E> accumulatorFunction)

Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатом применения заданной функции к текущему и заданным значениям, возвращая обновлённое значение.
E compareAndExchange​(int i, E expectedValue, E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchange(java.lang.Object...).
E compareAndExchangeAcquire​(int i, E expectedValue, E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...).
E compareAndExchangeRelease​(int i, E expectedValue, E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...).
boolean compareAndSet​(int i, E expectedValue, E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue, если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...).
E get​(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getVolatile(java.lang.Object...).
E getAcquire​(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAcquire(java.lang.Object...).
E getAndAccumulate​(int i, E x, BinaryOperator<E> accumulatorFunction)

Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатом применения заданной функции к текущему и заданным значениям, возвращая предыдущее значение.
E getAndSet​(int i, E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue и возвращает старое значение, с эффектами памяти, как указано в VarHandle.getAndSet(java.lang.Object...).
E getAndUpdate​(int i, UnaryOperator<E> updateFunction)

Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатом применения заданной функции, возвращая предыдущее значение.
E getOpaque​(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getOpaque(java.lang.Object...).
E getPlain​(int i)

Возвращает текущее значение элемента по индексу i, с семантикой памяти чтения, как если бы переменная была объявлена не-volatile.
void lazySet​(int i, E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...).
int length()

Возвращает длину массива.
void set​(int i, E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setVolatile(java.lang.Object...).
void setOpaque​(int i, E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setOpaque(java.lang.Object...).
void setPlain​(int i, E newValue)

Устанавливает элемент по индексу i в значение newValue, с семантикой памяти установки, как если бы переменная была объявлена не-volatile и не-final.
void setRelease​(int i, E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...).
String toString()

Возвращает строковое представление текущих значений массива.
E updateAndGet​(int i, UnaryOperator<E> updateFunction)

Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатом применения заданной функции, возвращая обновлённое значение.
boolean weakCompareAndSet​(int i, E expectedValue, E newValue)

Устарело.

Этот метод имеет явные эффекты памяти, но имя метода подразумевает эффекты памяти volatile (см. методы, такие как compareAndExchange(int, E, E) и compareAndSet(int, E, E)).
boolean weakCompareAndSetAcquire​(int i, E expectedValue, E newValue)

Возможно, атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetAcquire(java.lang.Object...).
boolean weakCompareAndSetPlain​(int i, E expectedValue, E newValue)

Возможно, атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...).
boolean weakCompareAndSetRelease​(int i, E expectedValue, E newValue)

Возможно, атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.Object...).
boolean weakCompareAndSetVolatile​(int i, E expectedValue, E newValue)

Возможно, атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSet(java.lang.Object...).

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

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, с эффектами памяти, как указано в VarHandle.getVolatile(java.lang.Object...).

Параметры:
i - индекс
Возвращает:
текущее значение

set

public final void set(int i,
                      E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setVolatile(java.lang.Object...).

Параметры:
i - индекс
newValue - новое значение

lazySet

public final void lazySet(int i,
                          E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...).

Параметры:
i - индекс
newValue - новое значение
С:
1.6

getAndSet

public final E getAndSet(int i,
                         E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue и возвращает старое значение, с эффектами памяти, как указано в VarHandle.getAndSet(java.lang.Object...).

Параметры:
i - индекс
newValue - новое значение
Возвращает:
предыдущее значение

compareAndSet

public final boolean compareAndSet(int i,
                                   E expectedValue,
                                   E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true в случае успеха. Возвращение False указывает, что фактическое значение не было равно ожидаемому значению.

weakCompareAndSet

@Deprecated(since="9")
public final boolean weakCompareAndSet(int i,
                                       E expectedValue,
                                       E newValue)
Устарело.
Этот метод имеет простые эффекты памяти, но имя метода подразумевает эффекты памяти volatile (см. методы такие как compareAndExchange(int, E, E) и compareAndSet(int, E, E)). Чтобы избежать путаницы с простыми или volatile эффектами памяти, рекомендуется использовать метод weakCompareAndSetPlain(int, E, E) вместо него.

Возможно атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true в случае успеха
См. также:
weakCompareAndSetPlain(int, E, E)

weakCompareAndSetPlain

public final boolean weakCompareAndSetPlain(int i,
                                            E expectedValue,
                                            E newValue)

Возможно атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true в случае успеха
С:
9

getAndUpdate

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

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

Параметры:
i - индекс
updateFunction - функция без побочных эффектов
Возвращает:
предыдущее значение
С:
1.8

updateAndGet

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

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

Параметры:
i - индекс
updateFunction - функция без побочных эффектов
Возвращает:
обновлённое значение
С:
1.8

getAndAccumulate

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

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

Параметры:
i - индекс
x - значение обновления
accumulatorFunction - функция без побочных эффектов от двух аргументов
Возвращает:
предыдущее значение
С:
1.8

accumulateAndGet

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

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

Параметры:
i - индекс
x - значение обновления
accumulatorFunction - функция без побочных эффектов от двух аргументов
Возвращает:
обновлённое значение
С:
1.8

toString

public String toString()

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

Переопределяет:
toString в классе Object
Возвращает:
строковое представление текущих значений массива

getPlain

public final E getPlain(int i)

Возвращает текущее значение элемента по индексу i, с семантикой памяти чтения, как если бы переменная была объявлена не-volatile.

Параметры:
i - индекс
Возвращает:
значение
С:
9

setPlain

public final void setPlain(int i,
                           E newValue)

Устанавливает элемент по индексу i в значение newValue, с семантикой памяти установки, как если бы переменная была объявлена не-volatile и не-final.

Параметры:
i - индекс
newValue - новое значение
С:
9

getOpaque

public final E getOpaque(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getOpaque(java.lang.Object...).

Параметры:
i - индекс
Возвращает:
значение
С:
9

setOpaque

public final void setOpaque(int i,
                            E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setOpaque(java.lang.Object...).

Параметры:
i - индекс
newValue - новое значение
С:
9

getAcquire

public final E getAcquire(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAcquire(java.lang.Object...).

Параметры:
i - индекс
Возвращает:
значение
С:
9

setRelease

public final void setRelease(int i,
                             E newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...).

Параметры:
i - индекс
newValue - новое значение
С:
9

compareAndExchange

public final E compareAndExchange(int i,
                                  E expectedValue,
                                  E newValue)

Атомарно устанавливает элемент по индексу i в значение newValue если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchange(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
значение свидетеля, которое будет таким же, как ожидаемое значение, если операция прошла успешно
С момента:
9

compareAndExchangeAcquire

public final E compareAndExchangeAcquire(int i,
                                         E expectedValue,
                                         E newValue)

Атомарно устанавливает элемент по индексу i на newValue, если текущее значение элемента, называемое значением свидетеля, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
значение свидетеля, которое будет таким же, как ожидаемое значение, если операция прошла успешно
С момента:
9

compareAndExchangeRelease

public final E compareAndExchangeRelease(int i,
                                         E expectedValue,
                                         E newValue)

Атомарно устанавливает элемент по индексу i на newValue, если текущее значение элемента, называемое значением свидетеля, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
значение свидетеля, которое будет таким же, как ожидаемое значение, если операция прошла успешно
С момента:
9

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(int i,
                                               E expectedValue,
                                               E newValue)

Возможно, атомарно устанавливает элемент по индексу i на newValue, если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSet(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true если операция прошла успешно
С момента:
9

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(int i,
                                              E expectedValue,
                                              E newValue)

Возможно, атомарно устанавливает элемент по индексу i на newValue, если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetAcquire(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true если операция прошла успешно
С момента:
9

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(int i,
                                              E expectedValue,
                                              E newValue)

Возможно, атомарно устанавливает элемент по индексу i на newValue, если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.Object...).

Параметры:
i - индекс
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true если операция прошла успешно
С момента:
9

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/atomic/AtomicReferenceArray.html

Spec-Zone .ru
спецификации, руководства, описания, API