Класс AtomicLongFieldUpdater<T>

java.lang.Object

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

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

public abstract class AtomicLongFieldUpdater<T> extends Object

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

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

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

С момента:: 1.5

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

AtomicLongFieldUpdater()

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

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

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

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

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

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

AtomicLongFieldUpdater

protected AtomicLongFieldUpdater()

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

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

newUpdater

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

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

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

compareAndSet

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

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

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

weakCompareAndSet

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

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

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

set

public abstract void set(T obj, long newValue)

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

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

lazySet

public abstract void lazySet(T obj, long newValue)

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

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

get

public abstract long get(T obj)

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

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

getAndSet

public long getAndSet(T obj, long newValue)

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

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

getAndIncrement

public long getAndIncrement(T obj)

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

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

getAndDecrement

public long getAndDecrement(T obj)

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

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

getAndAdd

public long getAndAdd(T obj, long delta)

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

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

incrementAndGet

public long incrementAndGet(T obj)

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

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

decrementAndGet

public long decrementAndGet(T obj)

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

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

addAndGet

public long addAndGet(T obj, long delta)

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

getAndUpdate

public final long getAndUpdate(T obj, LongUnaryOperator updateFunction)

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

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

updateAndGet

public final long updateAndGet(T obj, LongUnaryOperator updateFunction)

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

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

getAndAccumulate

public final long getAndAccumulate(T obj, long x, LongBinaryOperator accumulatorFunction)

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

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

accumulateAndGet

public final long accumulateAndGet(T obj, long x, LongBinaryOperator accumulatorFunction)

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

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

© 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/AtomicLongFieldUpdater.html