Класс AtomicIntegerFieldUpdater<T>

java.lang.Object

java.util.concurrent.atomic.AtomicIntegerFieldUpdater<T>

Type Parameters:: T - Тип объекта, содержащего обновляемое поле

public abstract class AtomicIntegerFieldUpdater<T> extends Object

Утилита на основе рефлексии, которая позволяет выполнять атомарные обновления заданных volatile int полей заданных классов. Этот класс предназначен для использования в атомарных структурах данных, в которых несколько полей одного узла независимо подвергаются атомарным обновлениям.

Обратите внимание, что гарантии метода compareAndSet в этом классе слабее, чем в других атомарных классах. Поскольку этот класс не может гарантировать, что все использования поля подходят для целей атомарного доступа, он может гарантировать атомарность только относительно других вызовов compareAndSet и set для одного и того же апдейтера.

Объектные аргументы для параметров типа T , которые не являются экземплярами класса, переданного newUpdater(java.lang.Class<U>, java.lang.String), приведут к тому, что будет брошено исключение ClassCastException.

Since:: 1.5

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

AtomicIntegerFieldUpdater()

Модификатор	Конструктор	Описание
`protected`	Защищенный конструктор без действий, используемый подклассами.

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

Модификатор и тип	Метод	Описание
`final int`	`accumulateAndGet(T obj, int x, IntBinaryOperator accumulatorFunction)`	Атомарно обновляет (с эффектами памяти, указанными в `VarHandle.compareAndSet(java.lang.Object...)`) поле заданного объекта, управляемого этим апдейтером, результатом применения заданной функции к текущему и заданному значениям, возвращая обновленное значение.
`int`	`addAndGet(T obj, int delta)`	Атомарно добавляет заданное значение к текущему значению поля заданного объекта, управляемого этим апдейтером.
`abstract boolean`	`compareAndSet(T obj, int expect, int update)`	Атомарно устанавливает поле заданного объекта, управляемого этим апдейтером, в заданное обновленное значение, если текущее значение `==` ожидаемое значение.
`int`	`decrementAndGet(T obj)`	Атомарно уменьшает на единицу текущее значение поля заданного объекта, управляемого этим апдейтером.
`abstract int`	`get(T obj)`	Возвращает текущее значение, хранящееся в поле заданного объекта, управляемого этим апдейтером.
`final int`	`getAndAccumulate(T obj, int x, IntBinaryOperator accumulatorFunction)`	Атомарно обновляет (с эффектами памяти, указанными в `VarHandle.compareAndSet(java.lang.Object...)`) поле заданного объекта, управляемого этим апдейтером, результатом применения заданной функции к текущему и заданному значениям, возвращая предыдущее значение.
`int`	`getAndAdd(T obj, int delta)`	Атомарно добавляет заданное значение к текущему значению поля заданного объекта, управляемого этим апдейтером.
`int`	`getAndDecrement(T obj)`	Атомарно уменьшает на единицу текущее значение поля заданного объекта, управляемого этим апдейтером.
`int`	`getAndIncrement(T obj)`	Атомарно увеличивает на единицу текущее значение поля заданного объекта, управляемого этим апдейтером.
`int`	`getAndSet(T obj, int newValue)`	Атомарно устанавливает поле заданного объекта, управляемого этим апдейтером, в заданное значение и возвращает старое значение.
`final int`	`getAndUpdate(T obj, IntUnaryOperator updateFunction)`	Атомарно обновляет (с эффектами памяти, указанными в `VarHandle.compareAndSet(java.lang.Object...)`) поле заданного объекта, управляемого этим апдейтером, результатом применения заданной функции, возвращая предыдущее значение.
`int`	`incrementAndGet(T obj)`	Атомарно увеличивает на единицу текущее значение поля заданного объекта, управляемого этим апдейтером.
`abstract void`	`lazySet(T obj, int newValue)`	В конечном итоге устанавливает поле заданного объекта, управляемого этим апдейтером, в заданное обновленное значение.
`static <U> AtomicIntegerFieldUpdater<U>`	`newUpdater(Class<U> tclass, String fieldName)`	Создаёт и возвращает апдейтер для объектов с заданным полем.
`abstract void`	`set(T obj, int newValue)`	Устанавливает поле заданного объекта, управляемого этим апдейтером, в заданное обновленное значение.
`final int`	`updateAndGet(T obj, IntUnaryOperator updateFunction)`	Атомарно обновляет (с эффектами памяти, указанными в `VarHandle.compareAndSet(java.lang.Object...)`) поле заданного объекта, управляемого этим апдейтером, результатом применения заданной функции, возвращая обновленное значение.
`abstract boolean`	`weakCompareAndSet(T obj, int expect, int update)`	Атомарно устанавливает поле заданного объекта, управляемого этим апдейтером, в заданное обновленное значение, если текущее значение `==` ожидаемое значение.

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

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

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

AtomicIntegerFieldUpdater

protected AtomicIntegerFieldUpdater()

Защищённый конструктор без действий, используемый подклассами.

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

newUpdater

public static <U> AtomicIntegerFieldUpdater<U> newUpdater(Class<U> tclass, String fieldName)

Создаёт и возвращает обновитель для объектов с заданным полем. Аргумент Class необходим для проверки соответствия рефлексивных типов и типов дженериков.

Параметры типа:: U - тип экземпляров tclass
Параметры:: tclass - класс объектов, содержащих поле; fieldName - имя поля для обновления
Возвращает:: обновитель
Исключения:: IllegalArgumentException - если поле не является переменной типа volatile integer; RuntimeException - с вложенным исключением, основанным на рефлексии, если класс не содержит поле или имеет неправильный тип, или поле недоступно для вызывающей стороны в соответствии с контролем доступа к языку Java

compareAndSet

public abstract boolean compareAndSet(T obj, int expect, int update)

Атомарно устанавливает поле заданного объекта, управляемого этим обновителем, в заданное обновлённое значение, если текущее значение == ожидаемого значения. Этот метод гарантированно является атомарным по отношению к другим вызовам compareAndSet и set, но не обязательно по отношению к другим изменениям в поле.

Параметры:: obj - Объект, поле которого условно установить; expect - ожидаемое значение; update - новое значение
Возвращает:: true при успехе

weakCompareAndSet

public abstract boolean weakCompareAndSet(T obj, int expect, int update)

Эта операция может ложно завершаться и не предоставляет гарантий упорядоченности, поэтому является лишь редкой альтернативой compareAndSet.

Параметры:: obj - Объект, поле которого условно установить; expect - ожидаемое значение; update - новое значение
Возвращает:: true при успехе

set

public abstract void set(T obj, int newValue)

Устанавливает поле заданного объекта, управляемого этим обновителем, в заданное обновлённое значение. Эта операция гарантированно действует как хранение volatile относительно последующих вызовов compareAndSet.

Параметры:: obj - Объект, поле которого установить; newValue - новое значение

lazySet

public abstract void lazySet(T obj, int newValue)

В конечном итоге устанавливает поле заданного объекта, управляемого этим обновителем, в заданное обновлённое значение.

Параметры:: obj - Объект, поле которого установить; newValue - новое значение
С:: 1.6

get

public abstract int get(T obj)

Возвращает текущее значение, хранящееся в поле заданного объекта, управляемого этим обновителем.

Параметры:: obj - Объект, поле которого получить
Возвращает:: текущее значение

getAndSet

public int getAndSet(T obj, int newValue)

Атомарно устанавливает поле заданного объекта, управляемого этим обновителем, в заданное значение и возвращает старое значение.

Параметры:: obj - Объект, поле которого получить и установить; newValue - новое значение
Возвращает:: предыдущее значение

getAndIncrement

public int getAndIncrement(T obj)

Атомарно увеличивает на единицу текущее значение поля заданного объекта, управляемого этим обновителем.

Параметры:: obj - Объект, поле которого получить и установить
Возвращает:: предыдущее значение

getAndDecrement

public int getAndDecrement(T obj)

Атомарно уменьшает на единицу текущее значение поля заданного объекта, управляемого этим обновителем.

Параметры:: obj - Объект, поле которого получить и установить
Возвращает:: предыдущее значение

getAndAdd

public int getAndAdd(T obj, int delta)

Атомарно добавляет заданное значение к текущему значению поля заданного объекта, управляемого этим обновителем.

Параметры:: obj - Объект, поле которого получить и установить; delta - значение для добавления
Возвращает:: предыдущее значение

incrementAndGet

public int incrementAndGet(T obj)

Атомарно увеличивает на единицу текущее значение поля заданного объекта, управляемого этим обновителем.

Параметры:: obj - Объект, поле которого получить и установить
Возвращает:: обновлённое значение

decrementAndGet

public int decrementAndGet(T obj)

Атомарно уменьшает на единицу текущее значение поля заданного объекта, управляемого этим обновителем.

Параметры:: obj - Объект, поле которого получить и установить
Возвращает:: обновлённое значение

addAndGet

public int addAndGet(T obj, int delta)

Параметры:: obj - Объект, поле которого получить и установить; delta - значение для добавления
Возвращает:: обновлённое значение

getAndUpdate

public final int getAndUpdate(T obj, IntUnaryOperator updateFunction)

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

Параметры:: obj - Объект, поле которого получить и установить; updateFunction - функция без побочных эффектов
Возвращает:: предыдущее значение
С:: 1.8

updateAndGet

public final int updateAndGet(T obj, IntUnaryOperator updateFunction)

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

Параметры:: obj - Объект, поле которого получить и установить; updateFunction - функция без побочных эффектов
Возвращает:: обновлённое значение
С:: 1.8

getAndAccumulate

public final int getAndAccumulate(T obj, int x, IntBinaryOperator accumulatorFunction)

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

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

accumulateAndGet

public final int accumulateAndGet(T obj, int x, IntBinaryOperator accumulatorFunction)

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

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

© 1993, 2021, 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/17/docs/api/java.base/java/util/concurrent/atomic/AtomicIntegerFieldUpdater.html