- java.lang.Object
-
- java.util.concurrent.atomic.AtomicReference<V>
-
- 参数类型
-
V
- 此引用引用的对象类型
- 实现的所有接口
-
Serializable
public class AtomicReference<V>extends Objectimplements Serializable
可以原子方式更新的对象引用。 有关原子访问属性的描述,请参阅VarHandle
规范。- 从以下版本开始:
- 1.5
- 另请参见:
- Serialized Form
-
-
构造方法摘要
构造方法 构造器 描述 AtomicReference()
使用null初始值创建新的AtomicReference。AtomicReference(V initialValue)
使用给定的初始值创建新的AtomicReference。
-
方法摘要
所有方法 实例方法 具体的方法 弃用的方法 变量和类型 方法 描述 V
accumulateAndGet(V x, BinaryOperator<V> accumulatorFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值以及将给定函数应用于当前值和给定值的结果,返回更新的值。V
compareAndExchange(V expectedValue, V newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchange(java.lang.Object...)
。V
compareAndExchangeAcquire(V expectedValue, V newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeAcquire(java.lang.Object...)
。V
compareAndExchangeRelease(V expectedValue, V newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeRelease(java.lang.Object...)
。boolean
compareAndSet(V expectedValue, V newValue)
V
get()
返回当前值,具有VarHandle.getVolatile(java.lang.Object...)
指定的内存效果。V
getAcquire()
返回当前值,具有VarHandle.getAcquire(java.lang.Object...)
指定的内存效果。V
getAndAccumulate(V x, BinaryOperator<V> accumulatorFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值以及将给定函数应用于当前值和给定值的结果,返回先前值。V
getAndSet(V newValue)
以原子方式将值设置为newValue
并返回旧值,并使用VarHandle.getAndSet(java.lang.Object...)
指定的内存效果。V
getAndUpdate(UnaryOperator<V> updateFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值和应用给定函数的结果,返回先前的值。V
getOpaque()
返回当前值,具有VarHandle.getOpaque(java.lang.Object...)
指定的内存效果。V
getPlain()
返回当前值,读取的内存语义就像变量声明为非volatile
。void
lazySet(V newValue)
将值设置为newValue
,具有由VarHandle.setRelease(java.lang.Object...)
指定的记忆效果。void
set(V newValue)
将值设置为newValue
,具有由VarHandle.setVolatile(java.lang.Object...)
指定的记忆效果。void
setOpaque(V newValue)
将值设置为newValue
,具有由VarHandle.setOpaque(java.lang.Object...)
指定的记忆效果。void
setPlain(V newValue)
将值设置为newValue
,设置的内存语义就像变量声明为非volatile
和非final
。void
setRelease(V newValue)
将值设置为newValue
,具有VarHandle.setRelease(java.lang.Object...)
指定的记忆效果。String
toString()
返回当前值的String表示形式。V
updateAndGet(UnaryOperator<V> updateFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值和应用给定函数的结果,返回更新的值。boolean
weakCompareAndSet(V expectedValue, V newValue)
已过时。此方法具有简单的记忆效应,但方法名称意味着易失性记忆效应(请参阅compareAndExchange(V, V)
和compareAndSet(V, V)
等方法)。boolean
weakCompareAndSetAcquire(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetAcquire(java.lang.Object...)
。boolean
weakCompareAndSetPlain(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetPlain(java.lang.Object...)
。boolean
weakCompareAndSetRelease(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetRelease(java.lang.Object...)
。boolean
weakCompareAndSetVolatile(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSet(java.lang.Object...)
。
-
-
-
构造方法详细信息
-
AtomicReference
public AtomicReference(V initialValue)
使用给定的初始值创建新的AtomicReference。- 参数
-
initialValue
- 初始值
-
AtomicReference
public AtomicReference()
使用null初始值创建新的AtomicReference。
-
-
方法详细信息
-
get
public final V get()
返回当前值,具有VarHandle.getVolatile(java.lang.Object...)
指定的内存效果。- 结果
- 当前的价值
-
set
public final void set(V newValue)
将值设置为newValue
,具有由VarHandle.setVolatile(java.lang.Object...)
指定的记忆效果。- 参数
-
newValue
- 新值
-
lazySet
public final void lazySet(V newValue)
将值设置为newValue
,具有VarHandle.setRelease(java.lang.Object...)
指定的记忆效果。- 参数
-
newValue
- 新值 - 从以下版本开始:
- 1.6
-
compareAndSet
public final boolean compareAndSet(V expectedValue, V newValue)
- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
如果成功。 错误返回表示实际值不等于预期值。
-
weakCompareAndSet
@Deprecated(since="9")public final boolean weakCompareAndSet(V expectedValue, V newValue)
Deprecated.This method has plain memory effects but the method name implies volatile memory effects (see methods such ascompareAndExchange(V, V)
andcompareAndSet(V, V)
). To avoid confusion over plain or volatile memory effects it is recommended that the methodweakCompareAndSetPlain(V, V)
be used instead.可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetPlain(java.lang.Object...)
。- 参数
-
expectedValue
- 期望值 -
newValue
- 新值 - 结果
-
true
如果成功 - 另请参见:
-
weakCompareAndSetPlain(V, V)
-
weakCompareAndSetPlain
public final boolean weakCompareAndSetPlain(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetPlain(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
如果成功 - 从以下版本开始:
- 9
-
getAndSet
public final V getAndSet(V newValue)
以原子方式将值设置为newValue
并返回旧值,并使用VarHandle.getAndSet(java.lang.Object...)
指定的内存效果。- 参数
-
newValue
- 新值 - 结果
- 以前的值
-
getAndUpdate
public final V getAndUpdate(UnaryOperator<V> updateFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值和应用给定函数的结果,返回先前的值。 该函数应该是无副作用的,因为当尝试的更新由于线程之间的争用而失败时,它可能会被重新应用。- 参数
-
updateFunction
- 无副作用的功能 - 结果
- 以前的值
- 从以下版本开始:
- 1.8
-
updateAndGet
public final V updateAndGet(UnaryOperator<V> updateFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值和应用给定函数的结果,返回更新的值。 该函数应该是无副作用的,因为当尝试的更新由于线程之间的争用而失败时,它可能会被重新应用。- 参数
-
updateFunction
- 无副作用的功能 - 结果
- 更新的值
- 从以下版本开始:
- 1.8
-
getAndAccumulate
public final V getAndAccumulate(V x, BinaryOperator<V> accumulatorFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值以及将给定函数应用于当前值和给定值的结果,返回先前值。 该函数应该是无副作用的,因为当尝试的更新由于线程之间的争用而失败时,它可能会被重新应用。 该函数应用当前值作为其第一个参数,并将给定更新作为第二个参数。- 参数
-
x
- 更新值 -
accumulatorFunction
- 两个参数的无副作用函数 - 结果
- 以前的值
- 从以下版本开始:
- 1.8
-
accumulateAndGet
public final V accumulateAndGet(V x, BinaryOperator<V> accumulatorFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)当前值以及将给定函数应用于当前值和给定值的结果,返回更新的值。 该函数应该是无副作用的,因为当尝试的更新由于线程之间的争用而失败时,它可能会被重新应用。 该函数应用当前值作为其第一个参数,并将给定更新作为第二个参数。- 参数
-
x
- 更新值 -
accumulatorFunction
- 两个参数的无副作用函数 - 结果
- 更新的值
- 从以下版本开始:
- 1.8
-
getPlain
public final V getPlain()
返回当前值,读取的内存语义就像变量声明为非volatile
。- 结果
- 价值
- 从以下版本开始:
- 9
-
setPlain
public final void setPlain(V newValue)
将值设置为newValue
,设置的内存语义就像变量声明为非volatile
和非final
。- 参数
-
newValue
- 新值 - 从以下版本开始:
- 9
-
getOpaque
public final V getOpaque()
返回当前值,具有VarHandle.getOpaque(java.lang.Object...)
指定的内存效果。- 结果
- 价值
- 从以下版本开始:
- 9
-
setOpaque
public final void setOpaque(V newValue)
将值设置为newValue
,具有由VarHandle.setOpaque(java.lang.Object...)
指定的记忆效果。- 参数
-
newValue
- 新值 - 从以下版本开始:
- 9
-
getAcquire
public final V getAcquire()
返回当前值,具有VarHandle.getAcquire(java.lang.Object...)
指定的内存效果。- 结果
- 价值
- 从以下版本开始:
- 9
-
setRelease
public final void setRelease(V newValue)
将值设置为newValue
,具有由VarHandle.setRelease(java.lang.Object...)
指定的记忆效果。- 参数
-
newValue
- 新值 - 从以下版本开始:
- 9
-
compareAndExchange
public final V compareAndExchange(V expectedValue, V newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchange(java.lang.Object...)
。- 参数
-
expectedValue
- 期望值 -
newValue
- 新值 - 结果
- 见证值,如果成功则与预期值相同
- 从以下版本开始:
- 9
-
compareAndExchangeAcquire
public final V compareAndExchangeAcquire(V expectedValue, V newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeAcquire(java.lang.Object...)
。- 参数
-
expectedValue
- 期望值 -
newValue
- 新值 - 结果
- 见证值,如果成功则与预期值相同
- 从以下版本开始:
- 9
-
compareAndExchangeRelease
public final V compareAndExchangeRelease(V expectedValue, V newValue)
原子将值设置为newValue
如果当前值,被称为 证人值 ,== expectedValue
如通过指定,记忆效应VarHandle.compareAndExchangeRelease(java.lang.Object...)
。- 参数
-
expectedValue
- 期望值 -
newValue
- 新值 - 结果
- 见证值,如果成功则与预期值相同
- 从以下版本开始:
- 9
-
weakCompareAndSetVolatile
public final boolean weakCompareAndSetVolatile(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSet(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
如果成功 - 从以下版本开始:
- 9
-
weakCompareAndSetAcquire
public final boolean weakCompareAndSetAcquire(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetAcquire(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
如果成功 - 从以下版本开始:
- 9
-
weakCompareAndSetRelease
public final boolean weakCompareAndSetRelease(V expectedValue, V newValue)
可能原子将值设置为newValue
如果当前值== expectedValue
如通过指定,记忆效应VarHandle.weakCompareAndSetRelease(java.lang.Object...)
。- 参数
-
expectedValue
- 预期值 -
newValue
- 新值 - 结果
-
true
若有成功 - 从以下版本开始:
- 9
-
-