Класс AtomicBoolean

java.lang.Object

java.util.concurrent.atomic.AtomicBoolean

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

public class AtomicBoolean extends Object implements Serializable

Значение boolean, которое может обновляться атомарно. Описание свойств атомарных операций доступа см. в спецификации VarHandle. AtomicBoolean используется в приложениях, например для атомарно обновляемых флагов, и не может служить заменой Boolean.

Начиная с:

1.5

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`final boolean`	`compareAndExchange(boolean expectedValue, boolean newValue)`	Атомарно устанавливает значение в `newValue`, если текущее значение, называемое значением-свидетелем, `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.compareAndExchange(Object...)`.
`final boolean`	`compareAndExchangeAcquire(boolean expectedValue, boolean newValue)`	Атомарно устанавливает значение в `newValue`, если текущее значение, называемое значением-свидетелем, `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.compareAndExchangeAcquire(Object...)`.
`final boolean`	`compareAndExchangeRelease(boolean expectedValue, boolean newValue)`	Атомарно устанавливает значение в `newValue`, если текущее значение, называемое значением-свидетелем, `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.compareAndExchangeRelease(Object...)`.
`final boolean`	`compareAndSet(boolean expectedValue, boolean newValue)`	Атомарно устанавливает значение в `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.compareAndSet(Object...)`.
`final boolean`	`get()`	Возвращает текущее значение; эффекты памяти определены в соответствии с `VarHandle.getVolatile(Object...)`.
`final boolean`	`getAcquire()`	Возвращает текущее значение; эффекты памяти определены в соответствии с `VarHandle.getAcquire(Object...)`.
`final boolean`	`getAndSet(boolean newValue)`	Атомарно устанавливает значение в `newValue` и возвращает старое значение; эффекты памяти определены в соответствии с `VarHandle.getAndSet(Object...)`.
`final boolean`	`getOpaque()`	Возвращает текущее значение; эффекты памяти определены в соответствии с `VarHandle.getOpaque(Object...)`.
`final boolean`	`getPlain()`	Возвращает текущее значение с семантикой памяти, эквивалентной чтению переменной, объявленной как не-`volatile`.
`final void`	`lazySet(boolean newValue)`	Устанавливает значение в `newValue`; эффекты памяти определены в соответствии с `VarHandle.setRelease(Object...)`.
`final void`	`set(boolean newValue)`	Устанавливает значение в `newValue`; эффекты памяти определены в соответствии с `VarHandle.setVolatile(Object...)`.
`final void`	`setOpaque(boolean newValue)`	Устанавливает значение в `newValue`; эффекты памяти определены в соответствии с `VarHandle.setOpaque(Object...)`.
`final void`	`setPlain(boolean newValue)`	Устанавливает значение в `newValue` с семантикой памяти, эквивалентной записи в переменную, объявленную как не-`volatile` и не-`final`.
`final void`	`setRelease(boolean newValue)`	Устанавливает значение в `newValue`; эффекты памяти определены в соответствии с `VarHandle.setRelease(Object...)`.
`String`	`toString()`	Возвращает строковое представление текущего значения.
`boolean`	`weakCompareAndSet(boolean expectedValue, boolean newValue)`	Устарело. Этот метод имеет обычные эффекты памяти, однако его имя подразумевает volatile-эффекты памяти (см. такие методы, как `compareAndExchange(boolean, boolean)` и `compareAndSet(boolean, boolean)`).
`final boolean`	`weakCompareAndSetAcquire(boolean expectedValue, boolean newValue)`	Возможно, атомарно устанавливает значение в `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.weakCompareAndSetAcquire(Object...)`.
`boolean`	`weakCompareAndSetPlain(boolean expectedValue, boolean newValue)`	Возможно, атомарно устанавливает значение в `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.weakCompareAndSetPlain(Object...)`.
`final boolean`	`weakCompareAndSetRelease(boolean expectedValue, boolean newValue)`	Возможно, атомарно устанавливает значение в `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.weakCompareAndSetRelease(Object...)`.
`final boolean`	`weakCompareAndSetVolatile(boolean expectedValue, boolean newValue)`	Возможно, атомарно устанавливает значение в `newValue`, если текущее значение `== expectedValue`; эффекты памяти определены в соответствии с `VarHandle.weakCompareAndSet(Object...)`.

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

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

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

AtomicBoolean

public AtomicBoolean(boolean initialValue)

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

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

AtomicBoolean

public AtomicBoolean()

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

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

get

public final boolean get()

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

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

compareAndSet

public final boolean compareAndSet(boolean expectedValue, boolean newValue)

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

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

weakCompareAndSet

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

Устарело.

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

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

Параметры:

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

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

Возвращает:

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

См. также:

weakCompareAndSetPlain

public boolean weakCompareAndSetPlain(boolean expectedValue, boolean newValue)

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

set

public final void set(boolean newValue)

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

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

lazySet

public final void lazySet(boolean newValue)

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

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

getAndSet

public final boolean getAndSet(boolean newValue)

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

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

toString

public String toString()

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

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

getPlain

public final boolean getPlain()

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

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

setPlain

public final void setPlain(boolean newValue)

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

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

getOpaque

public final boolean getOpaque()

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

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

setOpaque

public final void setOpaque(boolean newValue)

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

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

getAcquire

public final boolean getAcquire()

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

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

setRelease

public final void setRelease(boolean newValue)

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

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

compareAndExchange

public final boolean compareAndExchange(boolean expectedValue, boolean newValue)

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

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

compareAndExchangeAcquire

public final boolean compareAndExchangeAcquire(boolean expectedValue, boolean newValue)

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

compareAndExchangeRelease

public final boolean compareAndExchangeRelease(boolean expectedValue, boolean newValue)

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

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(boolean expectedValue, boolean newValue)

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

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(boolean expectedValue, boolean newValue)

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

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(boolean expectedValue, boolean newValue)

Параметры:: 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/atomic/AtomicBoolean.html