Spec-Zone.ru › OpenJDK 27

Класс 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
Модификатор и тип Метод Описание
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()
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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(boolean, boolean)

weakCompareAndSetPlain

public boolean weakCompareAndSetPlain(boolean expectedValue, boolean newValue)
Возможно, атомарно устанавливает значение в newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetPlain(Object...).
Параметры:
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)
Атомарно устанавливает значение в newValue, если текущее значение, называемое значением-свидетелем, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchangeAcquire(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
значение-свидетель, которое в случае успеха совпадает с ожидаемым значением
Начиная с:
9

compareAndExchangeRelease

public final boolean compareAndExchangeRelease(boolean expectedValue, boolean newValue)
Атомарно устанавливает значение в newValue, если текущее значение, называемое значением-свидетелем, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchangeRelease(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
значение-свидетель, которое в случае успеха совпадает с ожидаемым значением
Начиная с:
9

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(boolean expectedValue, boolean newValue)
Возможно, атомарно устанавливает значение в newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSet(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха
Начиная с:
9

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(boolean expectedValue, boolean newValue)
Возможно, атомарно устанавливает значение в newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetAcquire(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха
Начиная с:
9

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(boolean expectedValue, boolean newValue)
Возможно, атомарно устанавливает значение в newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetRelease(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха
Начиная с:
9

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API