- java.lang.Object
-
- java.lang.Number
-
- java.util.concurrent.atomic.AtomicInteger
-
- All Implemented Interfaces:
-
Serializable
public class AtomicInteger extends Number implements Serializable
可能原子更新的值为int
。 有关原子访问属性的说明,请参阅VarHandle
规范。 一个AtomicInteger
用于诸如原子增量计数器的应用中,不能用作Integer
的替代品。 但是,该类确实扩展了Number
以允许使用基于数字类的工具和实用程序的统一访问。- 从以下版本开始:
- 1.5
- 另请参见:
- Serialized Form
-
-
构造方法摘要
构造方法 Constructor 描述 AtomicInteger()
创建一个新的AtomicInteger,初始值为0
。AtomicInteger(int initialValue)
用给定的初始值创建一个新的AtomicInteger。
-
方法摘要
所有方法 接口方法 具体的方法 弃用的方法 Modifier and Type 方法 描述 int
accumulateAndGet(int x, IntBinaryOperator accumulatorFunction)
将当前值与给定函数应用于当前值和给定值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的内存效应),返回更新后的值。int
addAndGet(int delta)
将给定的值原子地添加到当前值,具有由VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果。int
compareAndExchange(int expectedValue, int newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchange(java.lang.Object...)
。int
compareAndExchangeAcquire(int expectedValue, int newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeAcquire(java.lang.Object...)
。int
compareAndExchangeRelease(int expectedValue, int newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeRelease(java.lang.Object...)
。boolean
compareAndSet(int expectedValue, int newValue)
int
decrementAndGet()
按照VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果原子减少当前值。double
doubleValue()
float
floatValue()
int
get()
返回当前值,具有VarHandle.getVolatile(java.lang.Object...)
指定的内存效果。int
getAcquire()
返回当前值,具有VarHandle.getAcquire(java.lang.Object...)
指定的内存效果。int
getAndAccumulate(int x, IntBinaryOperator accumulatorFunction)
将当前值与给定函数应用于当前值和给定值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的内存效应),返回上一个值。int
getAndAdd(int delta)
将给定的值原子地添加到当前值,具有由VarHandle.getAndAdd(java.lang.Object...)
指定的记忆效应。int
getAndDecrement()
按照VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果原则递减当前值。int
getAndIncrement()
按照VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果,原子地增加当前值。int
getAndSet(int newValue)
将值设置为newValue
并返回旧值,具有VarHandle.getAndSet(java.lang.Object...)
指定的内存效果。int
getAndUpdate(IntUnaryOperator updateFunction)
使用给定函数的结果对当前值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的内存效果),返回上一个值。int
getOpaque()
返回当前值,具有VarHandle.getOpaque(java.lang.Object...)
指定的内存效果。int
getPlain()
返回当前值,具有读取的内存语义,就好像变量被声明为非volatile
。int
incrementAndGet()
按照VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果,原子地增加当前值。int
intValue()
void
lazySet(int newValue)
将值设置为newValue
,具有VarHandle.setRelease(java.lang.Object...)
指定的内存效果。long
longValue()
void
set(int newValue)
将值设置为newValue
,具有VarHandle.setVolatile(java.lang.Object...)
指定的内存效果。void
setOpaque(int newValue)
将值设置为newValue
,具有VarHandle.setOpaque(java.lang.Object...)
指定的记忆效果。void
setPlain(int newValue)
将值设置为newValue
,其内存语义设置为该变量被声明为非volatile
final
。void
setRelease(int newValue)
将值设置为newValue
,具有VarHandle.setRelease(java.lang.Object...)
指定的内存效果。String
toString()
返回当前值的String表示形式。int
updateAndGet(IntUnaryOperator updateFunction)
使用给定函数的结果对当前值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的内存效果),返回更新的值。boolean
weakCompareAndSet(int expectedValue, int newValue)
已过时。该方法具有明显的记忆效应,但方法名称表示易失性记忆效应(参见compareAndExchange(int, int)
和compareAndSet(int, int)
等 )。 为了避免在平常或易失性记忆效应上的混淆,建议使用方法weakCompareAndSetPlain(int, int)
。boolean
weakCompareAndSetAcquire(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetAcquire(java.lang.Object...)
。boolean
weakCompareAndSetPlain(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetPlain(java.lang.Object...)
。boolean
weakCompareAndSetRelease(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetRelease(java.lang.Object...)
。boolean
weakCompareAndSetVolatile(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSet(java.lang.Object...)
。-
Methods inherited from class java.lang.Number
byteValue, shortValue
-
-
-
-
方法详细信息
-
get
public final int get()
返回当前值,具有VarHandle.getVolatile(java.lang.Object...)
指定的内存效果。- 结果
- 当前值
-
set
public final void set(int newValue)
将值设置为newValue
,具有VarHandle.setVolatile(java.lang.Object...)
指定的内存效果。- 参数
-
newValue
- 新值
-
lazySet
public final void lazySet(int newValue)
将值设置为newValue
,具有VarHandle.setRelease(java.lang.Object...)
指定的内存效果。- 参数
-
newValue
- 新价值 - 从以下版本开始:
- 1.6
-
getAndSet
public final int getAndSet(int newValue)
将值设置为newValue
并返回旧值,具有VarHandle.getAndSet(java.lang.Object...)
指定的内存效果。- 参数
-
newValue
- 新值 - 结果
- 以前的值
-
compareAndSet
public final boolean compareAndSet(int expectedValue, int newValue)
- 参数
-
expectedValue
- 期望值 -
newValue
- 新值 - 结果
-
true
如果成功。 False return表示实际值不等于预期值。
-
weakCompareAndSet
@Deprecated(since="9") public final boolean weakCompareAndSet(int expectedValue, int newValue)
已过时。 该方法具有明显的记忆效应,但方法名称表示易失性记忆效应(参见compareAndExchange(int, int)
和compareAndSet(int, int)
等方法)。 为了避免在平常或易失性记忆效应上的混淆,建议使用方法weakCompareAndSetPlain(int, int)
。可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetPlain(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
如果成功 - 另请参见:
-
weakCompareAndSetPlain(int, int)
-
weakCompareAndSetPlain
public final boolean weakCompareAndSetPlain(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetPlain(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
如果成功 - 从以下版本开始:
- 9
-
getAndIncrement
public final int getAndIncrement()
以VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果,原子地增加当前值。相当于
getAndAdd(1)
。- 结果
- 以前的值
-
getAndDecrement
public final int getAndDecrement()
按照VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果,原子递减当前值。相当于
getAndAdd(-1)
。- 结果
- 以前的值
-
getAndAdd
public final int getAndAdd(int delta)
原始地将给定的值添加到当前值,具有由VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果。- 参数
-
delta
- 要添加的值 - 结果
- 以前的值
-
incrementAndGet
public final int incrementAndGet()
按照VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果,原子地增加当前值。相当于
addAndGet(1)
。- 结果
- 更新的值
-
decrementAndGet
public final int decrementAndGet()
按照VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果,原子递减当前值。相当于
addAndGet(-1)
。- 结果
- 更新的值
-
addAndGet
public final int addAndGet(int delta)
原始地将给定的值添加到当前值,具有由VarHandle.getAndAdd(java.lang.Object...)
指定的内存效果。- 参数
-
delta
- 要添加的值 - 结果
- 更新的值
-
getAndUpdate
public final int getAndUpdate(IntUnaryOperator updateFunction)
使用给定函数的结果对当前值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的内存效果),返回上一个值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。- 参数
-
updateFunction
- 无副作用的功能 - 结果
- 以前的值
- 从以下版本开始:
- 1.8
-
updateAndGet
public final int updateAndGet(IntUnaryOperator updateFunction)
使用给定函数的结果对当前值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的存储器效果),返回更新的值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。- 参数
-
updateFunction
- 无副作用的功能 - 结果
- 更新的值
- 从以下版本开始:
- 1.8
-
getAndAccumulate
public final int getAndAccumulate(int x, IntBinaryOperator accumulatorFunction)
将当前值与给定函数应用于当前值和给定值的原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的存储器效应),返回上一个值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用当前值作为其第一个参数,给定的更新作为第二个参数。- 参数
-
x
- 更新值 -
accumulatorFunction
- 两个参数的副作用函数 - 结果
- 以前的值
- 从以下版本开始:
- 1.8
-
accumulateAndGet
public final int accumulateAndGet(int x, IntBinaryOperator accumulatorFunction)
将当前值与给定函数应用于当前值和给定值的原子更新(具有VarHandle.compareAndSet(java.lang.Object...)
指定的存储器效应),返回更新后的值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用当前值作为其第一个参数,给定的更新作为第二个参数。- 参数
-
x
- 更新值 -
accumulatorFunction
- 两个参数的无效副作用 - 结果
- 更新的值
- 从以下版本开始:
- 1.8
-
intValue
public int intValue()
将AtomicInteger
的当前值作为int
,具有VarHandle.getVolatile(java.lang.Object...)
指定的内存效果。 相当于get()
。
-
longValue
public long longValue()
-
floatValue
public float floatValue()
- Specified by:
-
floatValue
在Number
- 结果
-
该对象在转换为
float
型后表示的数值。 - See The Java™ Language Specification:
- 5.1.2扩大原始转换
-
doubleValue
public double doubleValue()
- Specified by:
-
doubleValue
在Number
- 结果
-
该对象在转换为
double
之后表示的数值。 - See The Java™ Language Specification:
- 5.1.2扩大原始转换
-
getPlain
public final int getPlain()
返回当前值,具有读取的内存语义,就好像变量被声明为非volatile
。- 结果
- 价值
- 从以下版本开始:
- 9
-
setPlain
public final void setPlain(int newValue)
将值设置为newValue
,具有设置的内存语义,如同该变量被宣告为非volatile
final
。- 参数
-
newValue
- 新值 - 从以下版本开始:
- 9
-
getOpaque
public final int getOpaque()
返回当前值,具有VarHandle.getOpaque(java.lang.Object...)
指定的内存效果。- 结果
- 价值
- 从以下版本开始:
- 9
-
setOpaque
public final void setOpaque(int newValue)
将值设置为newValue
,具有VarHandle.setOpaque(java.lang.Object...)
指定的内存效果。- 参数
-
newValue
- 新值 - 从以下版本开始:
- 9
-
getAcquire
public final int getAcquire()
返回当前值,具有VarHandle.getAcquire(java.lang.Object...)
指定的内存效果。- 结果
- 价值
- 从以下版本开始:
- 9
-
setRelease
public final void setRelease(int newValue)
将值设置为newValue
,具有VarHandle.setRelease(java.lang.Object...)
指定的内存效果。- 参数
-
newValue
- 新值 - 从以下版本开始:
- 9
-
compareAndExchange
public final int compareAndExchange(int expectedValue, int newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchange(java.lang.Object...)
。- 参数
-
expectedValue
- 期望值 -
newValue
- 新值 - 结果
- 见证价值,如果成功,将与预期价值相同
- 从以下版本开始:
- 9
-
compareAndExchangeAcquire
public final int compareAndExchangeAcquire(int expectedValue, int newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeAcquire(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新价值 - 结果
- 见证价值,如果成功,将与预期价值相同
- 从以下版本开始:
- 9
-
compareAndExchangeRelease
public final int compareAndExchangeRelease(int expectedValue, int newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeRelease(java.lang.Object...)
。- 参数
-
expectedValue
- 期望值 -
newValue
- 新值 - 结果
- 见证价值,如果成功,将与预期价值相同
- 从以下版本开始:
- 9
-
weakCompareAndSetVolatile
public final boolean weakCompareAndSetVolatile(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSet(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
如果成功 - 从以下版本开始:
- 9
-
weakCompareAndSetAcquire
public final boolean weakCompareAndSetAcquire(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetAcquire(java.lang.Object...)
。- 参数
-
expectedValue
- 期望值 -
newValue
- 新的价值 - 结果
-
true
如果成功 - 从以下版本开始:
- 9
-
weakCompareAndSetRelease
public final boolean weakCompareAndSetRelease(int expectedValue, int newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetRelease(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新的价值 - 结果
-
true
如果成功 - 从以下版本开始:
- 9
-
-