compact1, compact2, compact3

java.util.concurrent.atomic

Class AtomicReference<V>

java.lang.Object

java.util.concurrent.atomic.AtomicReference<V>

参数类型

V - 此引用引用的对象的类型

All Implemented Interfaces:

Serializable

public class AtomicReference<V>
extends Object
implements Serializable

可以原子更新的对象引用。 有关原子变量属性的描述，请参阅java.util.concurrent.atomic包规范。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
AtomicReference() 使用null初始值创建新的AtomicReference。
AtomicReference(V initialValue) 用给定的初始值创建一个新的AtomicReference。

方法摘要

Modifier and Type	Method and Description
V	accumulateAndGet(V x, BinaryOperator<V> accumulatorFunction) 使用将给定函数应用于当前值和给定值的结果原子更新当前值，返回更新后的值。
boolean	compareAndSet(V expect, V update) 如果当前值 ==为预期值，则将值设置为给定的更新值。
V	get() 获取当前值。
V	getAndAccumulate(V x, BinaryOperator<V> accumulatorFunction) 使用给定函数应用给当前值和给定值的结果原子更新当前值，返回上一个值。
V	getAndSet(V newValue) 将原子设置为给定值并返回旧值。
V	getAndUpdate(UnaryOperator<V> updateFunction) 用应用给定函数的结果原子更新当前值，返回上一个值。
void	lazySet(V newValue) 最终设定为给定值。
void	set(V newValue) 设置为给定值。
String	toString() 返回当前值的String表示形式。
V	updateAndGet(UnaryOperator<V> updateFunction) 使用给定函数的结果原子更新当前值，返回更新的值。
boolean	weakCompareAndSet(V expect, V update) 如果当前值为 == ，则将原值设置为给定的更新值。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

AtomicReference

public AtomicReference(V initialValue)

用给定的初始值创建一个新的AtomicReference。

参数

initialValue - 初始值

AtomicReference

public AtomicReference()

使用null初始值创建新的AtomicReference。

方法详细信息

get

public final V get()

获取当前值。

结果

当前值

set

public final void set(V newValue)

设置为给定值。

参数

newValue - 新价值

lazySet

public final void lazySet(V newValue)

最终设定为给定值。

参数

newValue - 新价值

从以下版本开始：

1.6

compareAndSet

public final boolean compareAndSet(V expect,
                                   V update)

如果当前值 ==为预期值，则将值设置为给定的更新值。

参数

expect - 预期值

update - 新的价值

结果

true如果成功。 False return表示实际值不等于预期值。

weakCompareAndSet

public final boolean weakCompareAndSet(V expect,
                                       V update)

如果当前值为==的预期值，则将该值原子设置为给定的更新值。

May fail spuriously and does not provide ordering guarantees ，所以只是很少适合替代compareAndSet 。

参数

expect - 预期值

update - 新的价值

结果

true如果成功

getAndSet

public final V getAndSet(V newValue)

将原子设置为给定值并返回旧值。

参数

newValue - 新值

结果

以前的值

getAndUpdate

public final V getAndUpdate(UnaryOperator<V> updateFunction)

用应用给定函数的结果原子更新当前值，返回上一个值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。

参数

updateFunction - 无副作用的功能

结果

以前的值

从以下版本开始：

1.8

updateAndGet

public final V updateAndGet(UnaryOperator<V> updateFunction)

使用给定函数的结果原子更新当前值，返回更新的值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。

参数

updateFunction - 无副作用的功能

结果

更新的值

从以下版本开始：

1.8

getAndAccumulate

public final V getAndAccumulate(V x,
                                BinaryOperator<V> accumulatorFunction)

使用给定函数应用给当前值和给定值的结果原子更新当前值，返回上一个值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。

参数

x - 更新值

accumulatorFunction - 两个参数的无副作用的函数

结果

以前的值

从以下版本开始：

1.8

accumulateAndGet

public final V accumulateAndGet(V x,
                                BinaryOperator<V> accumulatorFunction)

使用将给定函数应用于当前值和给定值的结果原子更新当前值，返回更新后的值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。

参数

x - 更新值

accumulatorFunction - 两个参数的无副作用函数

结果

更新的值

从以下版本开始：

1.8

toString

public String toString()

返回当前值的String表示形式。

重写：

toString在类别 Object

结果

当前值的String表示形式