Класс 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(java.lang.Object...)`.
`final boolean`	`compareAndExchangeAcquire(boolean expectedValue, boolean newValue)`	Атомарно устанавливает значение на `newValue`, если текущее значение, называемое свидетельским значением, `== expectedValue`, с эффектами памяти, как указано в `VarHandle.compareAndExchangeAcquire(java.lang.Object...)`.
`final boolean`	`compareAndExchangeRelease(boolean expectedValue, boolean newValue)`	Атомарно устанавливает значение на `newValue`, если текущее значение, называемое свидетельским значением, `== expectedValue`, с эффектами памяти, как указано в `VarHandle.compareAndExchangeRelease(java.lang.Object...)`.
`final boolean`	`compareAndSet(boolean expectedValue, boolean newValue)`	Атомарно устанавливает значение на `newValue`, если текущее значение `== expectedValue`, с эффектами памяти, как указано в `VarHandle.compareAndSet(java.lang.Object...)`.
`final boolean`	`get()`	Возвращает текущее значение, с эффектами памяти, как указано в `VarHandle.getVolatile(java.lang.Object...)`.
`final boolean`	`getAcquire()`	Возвращает текущее значение, с эффектами памяти, как указано в `VarHandle.getAcquire(java.lang.Object...)`.
`final boolean`	`getAndSet(boolean newValue)`	Атомарно устанавливает значение на `newValue` и возвращает старое значение, с эффектами памяти, как указано в `VarHandle.getAndSet(java.lang.Object...)`.
`final boolean`	`getOpaque()`	Возвращает текущее значение, с эффектами памяти, как указано в `VarHandle.getOpaque(java.lang.Object...)`.
`final boolean`	`getPlain()`	Возвращает текущее значение, с семантикой памяти чтения, как если бы переменная была объявлена не-`volatile`.
`final void`	`lazySet(boolean newValue)`	Устанавливает значение на `newValue`, с эффектами памяти, как указано в `VarHandle.setRelease(java.lang.Object...)`.
`final void`	`set(boolean newValue)`	Устанавливает значение на `newValue`, с эффектами памяти, как указано в `VarHandle.setVolatile(java.lang.Object...)`.
`final void`	`setOpaque(boolean newValue)`	Устанавливает значение на `newValue`, с эффектами памяти, как указано в `VarHandle.setOpaque(java.lang.Object...)`.
`final void`	`setPlain(boolean newValue)`	Устанавливает значение на `newValue`, с семантикой памяти установки, как если бы переменная была объявлена не-`volatile` и не-`final`.
`final void`	`setRelease(boolean newValue)`	Устанавливает значение на `newValue`, с эффектами памяти, как указано в `VarHandle.setRelease(java.lang.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(java.lang.Object...)`.
`boolean`	`weakCompareAndSetPlain(boolean expectedValue, boolean newValue)`	Возможная атомарная установка значения на `newValue`, если текущее значение `== expectedValue`, с эффектами памяти, как указано в `VarHandle.weakCompareAndSetPlain(java.lang.Object...)`.
`final boolean`	`weakCompareAndSetRelease(boolean expectedValue, boolean newValue)`	Возможная атомарная установка значения на `newValue`, если текущее значение `== expectedValue`, с эффектами памяти, как указано в `VarHandle.weakCompareAndSetRelease(java.lang.Object...)`.
`final boolean`	`weakCompareAndSetVolatile(boolean expectedValue, boolean newValue)`	Возможная атомарная установка значения на `newValue`, если текущее значение `== expectedValue`, с эффектами памяти, как указано в `VarHandle.weakCompareAndSet(java.lang.Object...)`.

Методы, объявленные в классе java.lang.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(java.lang.Object...).

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

compareAndSet

public final boolean compareAndSet(boolean expectedValue, boolean newValue)

Атомарно устанавливает значение на newValue, если текущее значение == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.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(java.lang.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(java.lang.Object...).

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

lazySet

public final void lazySet(boolean newValue)

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

Параметры:: newValue - новое значение
С:: 1.6

getAndSet

public final boolean getAndSet(boolean newValue)

Атомарно устанавливает значение на newValue и возвращает старое значение, с эффектами памяти, как указано в VarHandle.getAndSet(java.lang.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(java.lang.Object...).

Возвращает:: значение
С:: 9

setOpaque

public final void setOpaque(boolean newValue)

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

Параметры:: newValue - новое значение
С:: 9

getAcquire

public final boolean getAcquire()

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

Возвращает:: значение
С:: 9

setRelease

public final void setRelease(boolean newValue)

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

Параметры:: newValue - новое значение
С:: 9

compareAndExchange

public final boolean compareAndExchange(boolean expectedValue, boolean newValue)

Атомарно устанавливает значение на newValue, если текущее значение, называемое значение свидетеля, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchange(java.lang.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)

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

Параметры:: expectedValue - ожидаемое значение; newValue - новое значение
Возвращает:: true, если операция выполнена успешно
С:: 9

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(boolean expectedValue, boolean newValue)

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

Параметры:: expectedValue - ожидаемое значение; newValue - новое значение
Возвращает:: true, если успешно
С:: 9

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(boolean expectedValue, boolean newValue)

Возможно атомарно устанавливает значение на newValue, если текущее значение == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/concurrent/atomic/AtomicBoolean.html