Класс 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(boolean initialValue) | Создаёт новый |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean | compareAndExchange(boolean expectedValue,
boolean newValue) | Атомарно устанавливает значение на |
boolean | compareAndExchangeAcquire(boolean expectedValue,
boolean newValue) | Атомарно устанавливает значение на |
boolean | compareAndExchangeRelease(boolean expectedValue,
boolean newValue) | Атомарно устанавливает значение на |
boolean | compareAndSet(boolean expectedValue,
boolean newValue) | Атомарно устанавливает значение на |
boolean | get() | Возвращает текущее значение, с эффектами памяти, как указано в |
boolean | getAcquire() | Возвращает текущее значение, с эффектами памяти, как указано в |
boolean | getAndSet(boolean newValue) | Атомарно устанавливает значение на |
boolean | getOpaque() | Возвращает текущее значение, с эффектами памяти, как указано в |
boolean | getPlain() | Возвращает текущее значение, с семантикой памяти чтения, как если бы переменная была объявлена не- |
void | lazySet(boolean newValue) | Устанавливает значение на |
void | set(boolean newValue) | Устанавливает значение на |
void | setOpaque(boolean newValue) | Устанавливает значение на |
void | setPlain(boolean newValue) | Устанавливает значение на |
void | setRelease(boolean newValue) | Устанавливает значение на |
String | toString() | Возвращает строковое представление текущего значения. |
boolean | weakCompareAndSet(boolean expectedValue,
boolean newValue) | Устарело. Этот метод имеет простые эффекты памяти, но имя метода подразумевает эффекты памяти volatile (см. методы, такие как compareAndExchange(boolean, boolean) и compareAndSet(boolean, boolean)). |
boolean | weakCompareAndSetAcquire(boolean expectedValue,
boolean newValue) | Возможная атомарная установка значения на |
boolean | weakCompareAndSetPlain(boolean expectedValue,
boolean newValue) | Возможная атомарная установка значения на |
boolean | weakCompareAndSetRelease(boolean expectedValue,
boolean newValue) | Возможная атомарная установка значения на |
boolean | weakCompareAndSetVolatile(boolean expectedValue,
boolean newValue) | Возможная атомарная установка значения на |
Методы, объявленные в классе 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) compareAndExchange(boolean, boolean) и compareAndSet(boolean, boolean)). Чтобы избежать путаницы с обычными или volatile эффектами памяти, рекомендуется использовать метод weakCompareAndSetPlain(boolean, boolean) вместо этого.Возможно атомарно устанавливает значение на newValue если текущее значение == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...).
- Параметры:
-
expectedValue- ожидаемое значение -
newValue- новое значение - Возвращает:
-
trueв случае успеха - См. также:
weakCompareAndSetPlain(boolean, boolean)
weakCompareAndSetPlain
public boolean weakCompareAndSetPlain(boolean expectedValue,
boolean newValue) Возможно атомарно устанавливает значение на newValue если текущее значение == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...).
- Параметры:
-
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()
Возвращает строковое представление текущего значения.
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) Атомарно устанавливает значение на newValue если текущее значение, называемое значение свидетеля, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...).
- Параметры:
-
expectedValue- ожидаемое значение -
newValue- новое значение - Возвращает:
- значение свидетеля, которое будет таким же, как ожидаемое значение, в случае успеха
- С:
- 9
compareAndExchangeRelease
public final boolean compareAndExchangeRelease(boolean expectedValue,
boolean newValue) Атомарно устанавливает значение на newValue если текущее значение, называемое значение свидетеля, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...).
- Параметры:
-
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, 2020, 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/11/docs/api/java.base/java/util/concurrent/atomic/AtomicBoolean.html