Класс AtomicReferenceArray<E>
java.lang.Object
java.util.concurrent.atomic.AtomicReferenceArray<E>
- Параметры типа:
-
E- базовый класс элементов, хранящихся в этом массиве
- Все реализуемые интерфейсы:
Serializable
public class AtomicReferenceArray<E> extends Object implements Serializable
Массив ссылок на объекты, элементы которого могут обновляться атомарно. См. спецификацию
VarHandle для описания свойств атомарных обращений.- С тех пор:
- 1.5
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
AtomicReferenceArray |
Создает новый AtomicReferenceArray заданной длины, со всеми элементами, первоначально равными null. |
AtomicReferenceArray |
Создает новый AtomicReferenceArray с такой же длиной, как и в заданном массиве, и со всеми элементами, скопированными из заданного массива. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final E |
accumulateAndGet |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент в индексе i результатами применения заданной функции к текущему и заданному значениям, возвращая обновлённое значение. |
final E |
compareAndExchange |
Атомарно устанавливает элемент в индексе i в newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchange(java.lang.Object...). |
final E |
compareAndExchangeAcquire |
Атомарно устанавливает элемент в индексе i в newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...). |
final E |
compareAndExchangeRelease |
Атомарно устанавливает элемент в индексе i в newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...). |
final boolean |
compareAndSet |
Атомарно устанавливает элемент в индексе i в newValue, если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...). |
final E |
get |
Возвращает текущее значение элемента в индексе i, с эффектами памяти, как указано в VarHandle.getVolatile(java.lang.Object...). |
final E |
getAcquire |
Возвращает текущее значение элемента в индексе i, с эффектами памяти, как указано в VarHandle.getAcquire(java.lang.Object...). |
final E |
getAndAccumulate |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент в индексе i результатами применения заданной функции к текущему и заданному значениям, возвращая предыдущее значение. |
final E |
getAndSet |
Атомарно устанавливает элемент в индексе i в
newValue и возвращает старое значение, с эффектами памяти, как указано в VarHandle.getAndSet(java.lang.Object...). |
final E |
getAndUpdate |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент в индексе i результатами применения заданной функции, возвращая предыдущее значение. |
final E |
getOpaque |
Возвращает текущее значение элемента в индексе i, с эффектами памяти, как указано в VarHandle.getOpaque(java.lang.Object...). |
final E |
getPlain |
Возвращает текущее значение элемента в индексе i, с семантикой памяти чтения, как если бы переменная была объявлена не-volatile. |
final void |
lazySet |
Устанавливает элемент в индексе i в newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...). |
final int |
length() |
Возвращает длину массива. |
final void |
set |
Устанавливает элемент в индексе i в newValue, с эффектами памяти, как указано в VarHandle.setVolatile(java.lang.Object...). |
final void |
setOpaque |
Устанавливает элемент в индексе i в newValue, с эффектами памяти, как указано в VarHandle.setOpaque(java.lang.Object...). |
final void |
setPlain |
Устанавливает элемент в индексе i в newValue, с семантикой памяти установки, как если бы переменная была объявлена не-volatile и не-final. |
final void |
setRelease |
Устанавливает элемент в индексе i в newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...). |
String |
toString() |
Возвращает строковое представление текущих значений массива. |
final E |
updateAndGet |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент в индексе i результатами применения заданной функции, возвращая обновлённое значение. |
final boolean |
weakCompareAndSet |
Устарело. |
final boolean |
weakCompareAndSetAcquire |
Возможно атомарно устанавливает элемент в индексе i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetAcquire(java.lang.Object...). |
final boolean |
weakCompareAndSetPlain |
Возможно атомарно устанавливает элемент в индексе i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...). |
final boolean |
weakCompareAndSetRelease |
Возможно атомарно устанавливает элемент в индексе i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.Object...). |
final boolean |
weakCompareAndSetVolatile |
Возможно атомарно устанавливает элемент в индексе i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSet(java.lang.Object...). |
Подробное описание конструкторов
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
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, 2023, 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/21/docs/api/java.base/java/util/concurrent/atomic/AtomicReferenceArray.html
compareAndExchange(int, E, E)иcompareAndSet(int, E, E)).