Класс AtomicLong

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.AtomicLong

Все реализуемые интерфейсы:: Serializable

public class AtomicLong extends Number implements Serializable

Значение long, которое может обновляться атомарно. Описание свойств атомарного доступа см. в спецификации VarHandle. AtomicLong используется, например, в приложениях для атомарного увеличения номеров последовательностей и не может применяться вместо Long. Однако этот класс расширяет Number, чтобы обеспечить единообразный доступ для инструментов и утилит, работающих с классами, основанными на числовых значениях.

Начиная с:

1.5

См. также:

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

Конструктор	Описание
`AtomicLong()`	Создает новый AtomicLong с начальным значением `0`.
`AtomicLong(long initialValue)`	Создает новый AtomicLong с указанным начальным значением.

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

Модификатор и тип	Метод	Описание
`final long`	`accumulateAndGet(long x, LongBinaryOperator accumulatorFunction)`	Атомарно обновляет текущее значение результатом применения заданной функции к текущему и заданному значениям (с эффектами памяти, определенными в `VarHandle.compareAndSet(Object...)`) и возвращает обновленное значение.
`final long`	`addAndGet(long delta)`	Атомарно прибавляет заданное значение к текущему; эффекты памяти определены в `VarHandle.getAndAdd(Object...)`.
`final long`	`compareAndExchange(long expectedValue, long newValue)`	Атомарно устанавливает значение `newValue`, если текущее значение, называемое значением-свидетелем, `== expectedValue`; эффекты памяти определены в `VarHandle.compareAndExchange(Object...)`.
`final long`	`compareAndExchangeAcquire(long expectedValue, long newValue)`	Атомарно устанавливает значение `newValue`, если текущее значение, называемое значением-свидетелем, `== expectedValue`; эффекты памяти определены в `VarHandle.compareAndExchangeAcquire(Object...)`.
`final long`	`compareAndExchangeRelease(long expectedValue, long newValue)`	Атомарно устанавливает значение `newValue`, если текущее значение, называемое значением-свидетелем, `== expectedValue`; эффекты памяти определены в `VarHandle.compareAndExchangeRelease(Object...)`.
`final boolean`	`compareAndSet(long expectedValue, long newValue)`	Атомарно устанавливает значение `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в `VarHandle.compareAndSet(Object...)`.
`final long`	`decrementAndGet()`	Атомарно уменьшает текущее значение; эффекты памяти определены в `VarHandle.getAndAdd(Object...)`.
`double`	`doubleValue()`	Возвращает текущее значение этого `AtomicLong` в виде `double` после расширяющего преобразования примитивного типа; эффекты памяти определены в `VarHandle.getVolatile(Object...)`.
`float`	`floatValue()`	Возвращает текущее значение этого `AtomicLong` в виде `float` после расширяющего преобразования примитивного типа; эффекты памяти определены в `VarHandle.getVolatile(Object...)`.
`final long`	`get()`	Возвращает текущее значение; эффекты памяти определены в `VarHandle.getVolatile(Object...)`.
`final long`	`getAcquire()`	Возвращает текущее значение; эффекты памяти определены в `VarHandle.getAcquire(Object...)`.
`final long`	`getAndAccumulate(long x, LongBinaryOperator accumulatorFunction)`	Атомарно обновляет текущее значение результатом применения заданной функции к текущему и заданному значениям (с эффектами памяти, определенными в `VarHandle.compareAndSet(Object...)`) и возвращает предыдущее значение.
`final long`	`getAndAdd(long delta)`	Атомарно прибавляет заданное значение к текущему; эффекты памяти определены в `VarHandle.getAndAdd(Object...)`.
`final long`	`getAndDecrement()`	Атомарно уменьшает текущее значение; эффекты памяти определены в `VarHandle.getAndAdd(Object...)`.
`final long`	`getAndIncrement()`	Атомарно увеличивает текущее значение; эффекты памяти определены в `VarHandle.getAndAdd(Object...)`.
`final long`	`getAndSet(long newValue)`	Атомарно устанавливает значение `newValue` и возвращает старое значение; эффекты памяти определены в `VarHandle.getAndSet(Object...)`.
`final long`	`getAndUpdate(LongUnaryOperator updateFunction)`	Атомарно обновляет текущее значение результатом применения заданной функции (с эффектами памяти, определенными в `VarHandle.compareAndSet(Object...)`) и возвращает предыдущее значение.
`final long`	`getOpaque()`	Возвращает текущее значение; эффекты памяти определены в `VarHandle.getOpaque(Object...)`.
`final long`	`getPlain()`	Возвращает текущее значение с семантикой памяти, соответствующей чтению переменной, объявленной как non-`volatile`.
`final long`	`incrementAndGet()`	Атомарно увеличивает текущее значение; эффекты памяти определены в `VarHandle.getAndAdd(Object...)`.
`int`	`intValue()`	Возвращает текущее значение этого `AtomicLong` в виде `int` после сужающего преобразования примитивного типа; эффекты памяти определены в `VarHandle.getVolatile(Object...)`.
`final void`	`lazySet(long newValue)`	Устанавливает значение `newValue`; эффекты памяти определены в `VarHandle.setRelease(Object...)`.
`long`	`longValue()`	Возвращает текущее значение этого `AtomicLong` в виде `long`; эффекты памяти определены в `VarHandle.getVolatile(Object...)`.
`final void`	`set(long newValue)`	Устанавливает значение `newValue`; эффекты памяти определены в `VarHandle.setVolatile(Object...)`.
`final void`	`setOpaque(long newValue)`	Устанавливает значение `newValue`; эффекты памяти определены в `VarHandle.setOpaque(Object...)`.
`final void`	`setPlain(long newValue)`	Устанавливает значение `newValue` с семантикой памяти, соответствующей установке переменной, объявленной как non-`volatile` и non-`final`.
`final void`	`setRelease(long newValue)`	Устанавливает значение `newValue`; эффекты памяти определены в `VarHandle.setRelease(Object...)`.
`String`	`toString()`	Возвращает строковое представление текущего значения.
`final long`	`updateAndGet(LongUnaryOperator updateFunction)`	Атомарно обновляет текущее значение результатом применения заданной функции (с эффектами памяти, определенными в `VarHandle.compareAndSet(Object...)`) и возвращает обновленное значение.
`final boolean`	`weakCompareAndSet(long expectedValue, long newValue)`	Устарело. Этот метод имеет обычные эффекты памяти, но его имя подразумевает эффекты volatile-доступа к памяти (см. такие методы, как `compareAndExchange(long, long)` и `compareAndSet(long, long)`).
`final boolean`	`weakCompareAndSetAcquire(long expectedValue, long newValue)`	Может атомарно установить значение `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в `VarHandle.weakCompareAndSetAcquire(Object...)`.
`final boolean`	`weakCompareAndSetPlain(long expectedValue, long newValue)`	Может атомарно установить значение `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в `VarHandle.weakCompareAndSetPlain(Object...)`.
`final boolean`	`weakCompareAndSetRelease(long expectedValue, long newValue)`	Может атомарно установить значение `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в `VarHandle.weakCompareAndSetRelease(Object...)`.
`final boolean`	`weakCompareAndSetVolatile(long expectedValue, long newValue)`	Может атомарно установить значение `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в `VarHandle.weakCompareAndSet(Object...)`.

Методы, объявленные в классе Number

byteValue, shortValue

Модификатор и тип	Метод	Описание
`byte`	`byteValue()`	Возвращает значение указанного числа в виде `byte`.
`short`	`shortValue()`	Возвращает значение указанного числа в виде `short`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

AtomicLong

public AtomicLong(long initialValue)

Создает новый AtomicLong с заданным начальным значением.

Параметры:: initialValue — начальное значение

AtomicLong

public AtomicLong()

Создает новый AtomicLong с начальным значением 0.

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

get

public final long get()

Возвращает текущее значение с эффектами памяти, указанными в VarHandle.getVolatile(Object...).

Возвращает:: текущее значение

set

public final void set(long newValue)

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

Параметры:: newValue — новое значение

lazySet

public final void lazySet(long newValue)

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

Параметры:: newValue — новое значение
Начиная с версии:: 1.6

getAndSet

public final long getAndSet(long newValue)

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

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

compareAndSet

public final boolean compareAndSet(long expectedValue, long newValue)

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

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: true в случае успеха. Возврат значения false означает, что фактическое значение не совпало с ожидаемым.

weakCompareAndSet

@Deprecated(since="9") public final boolean weakCompareAndSet(long expectedValue, long newValue)

Устарел.

Этот метод имеет обычные эффекты памяти, но его имя подразумевает эффекты volatile (см. такие методы, как compareAndExchange(long, long) и compareAndSet(long, long)). Чтобы избежать путаницы между обычными эффектами памяти и эффектами volatile, рекомендуется использовать метод weakCompareAndSetPlain(long, long).

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

Параметры:

expectedValue — ожидаемое значение

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

Возвращает:

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

См. также:

weakCompareAndSetPlain

public final boolean weakCompareAndSetPlain(long expectedValue, long newValue)

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: true в случае успеха
Начиная с версии:: 9

getAndIncrement

public final long getAndIncrement()

Атомарно увеличивает текущее значение на единицу с эффектами памяти, указанными в VarHandle.getAndAdd(Object...).

Эквивалентно getAndAdd(1).

Возвращает:: предыдущее значение

getAndDecrement

public final long getAndDecrement()

Атомарно уменьшает текущее значение на единицу с эффектами памяти, указанными в VarHandle.getAndAdd(Object...).

Эквивалентно getAndAdd(-1).

Возвращает:: предыдущее значение

getAndAdd

public final long getAndAdd(long delta)

Атомарно прибавляет заданное значение к текущему значению с эффектами памяти, указанными в VarHandle.getAndAdd(Object...).

Параметры:: delta — значение, которое нужно прибавить
Возвращает:: предыдущее значение

incrementAndGet

public final long incrementAndGet()

Атомарно увеличивает текущее значение на единицу с эффектами памяти, указанными в VarHandle.getAndAdd(Object...).

Эквивалентно addAndGet(1).

Возвращает:: обновленное значение

decrementAndGet

public final long decrementAndGet()

Атомарно уменьшает текущее значение на единицу с эффектами памяти, указанными в VarHandle.getAndAdd(Object...).

Эквивалентно addAndGet(-1).

Возвращает:: обновленное значение

addAndGet

public final long addAndGet(long delta)

Параметры:: delta — значение, которое нужно прибавить
Возвращает:: обновленное значение

getAndUpdate

public final long getAndUpdate(LongUnaryOperator updateFunction)

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

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

updateAndGet

public final long updateAndGet(LongUnaryOperator updateFunction)

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

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

getAndAccumulate

public final long getAndAccumulate(long x, LongBinaryOperator accumulatorFunction)

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

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

accumulateAndGet

public final long accumulateAndGet(long x, LongBinaryOperator accumulatorFunction)

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

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

toString

public String toString()

Возвращает строковое представление текущего значения.

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

intValue

public int intValue()

Возвращает текущее значение этого AtomicLong как int после сужающего преобразования примитивного типа с эффектами памяти, указанными в VarHandle.getVolatile(Object...).

Определено в:: intValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу int.
См. Спецификацию языка Java:: 5.1.3 Сужающее преобразование примитивного типа

longValue

public long longValue()

Возвращает текущее значение этого AtomicLong как long с эффектами памяти, указанными в VarHandle.getVolatile(Object...). Эквивалентно get().

Определено в:: longValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу long.

floatValue

public float floatValue()

Возвращает текущее значение этого AtomicLong как float после расширяющего преобразования примитивного типа с эффектами памяти, указанными в VarHandle.getVolatile(Object...).

Определено в:: floatValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу float.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивного типа

doubleValue

public double doubleValue()

Возвращает текущее значение этого AtomicLong как double после расширяющего преобразования примитивного типа с эффектами памяти, указанными в VarHandle.getVolatile(Object...).

Определено в:: doubleValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу double.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивного типа

getPlain

public final long getPlain()

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

Возвращает:: значение
Начиная с версии:: 9

setPlain

public final void setPlain(long newValue)

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

Параметры:: newValue — новое значение
Начиная с версии:: 9

getOpaque

public final long getOpaque()

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

Возвращает:: значение
Начиная с версии:: 9

setOpaque

public final void setOpaque(long newValue)

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

Параметры:: newValue — новое значение
Начиная с версии:: 9

getAcquire

public final long getAcquire()

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

Возвращает:: значение
Начиная с версии:: 9

setRelease

public final void setRelease(long newValue)

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

Параметры:: newValue — новое значение
Начиная с версии:: 9

compareAndExchange

public final long compareAndExchange(long expectedValue, long newValue)

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

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: значение-свидетель, которое в случае успеха совпадает с ожидаемым значением
Начиная с версии:: 9

compareAndExchangeAcquire

public final long compareAndExchangeAcquire(long expectedValue, long newValue)

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: значение-свидетель, которое в случае успеха совпадает с ожидаемым значением
Начиная с версии:: 9

compareAndExchangeRelease

public final long compareAndExchangeRelease(long expectedValue, long newValue)

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: значение-свидетель, которое в случае успеха совпадает с ожидаемым значением
Начиная с версии:: 9

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(long expectedValue, long newValue)

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

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: true в случае успеха
Начиная с версии:: 9

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(long expectedValue, long newValue)

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

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: true в случае успеха
Начиная с версии:: 9

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(long expectedValue, long newValue)

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

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: true в случае успеха
Начиная с версии:: 9

© 1993, 2025, 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.