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包装规范。

从以下版本开始：

一点五

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
AtomicReference() 创建具有零初始值的一种新的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() 返回当前值的字符串表示形式。
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

Constructor Detail

AtomicReference

public AtomicReference(V initialValue)

创建具有给定的初始值的一种新的AtomicReference。

参数

initialValue的初始值

AtomicReference

public AtomicReference()

创建具有零初始值的一种新的atomicreference。

方法详细信息

get

public final V get()

获取当前值。

结果

目前的价值

set

public final void set(V newValue)

给定值的集合。

参数

newValue -新价值

lazySet

public final void lazySet(V newValue)

最终设置为给定的值。

参数

newValue -新价值

从以下版本开始：

一点六

compareAndSet

public final boolean compareAndSet(V expect,
                                   V update)

自动设置的值来指定更新值，如果电流值 ==期望值。

参数

expect -期望值

update -新价值

结果

true如果成功。错误返回表示实际值不等于期望值。

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 -无副作用的功能

结果

以前的值

从以下版本开始：

一点八

updateAndGet

public final V updateAndGet(UnaryOperator<V> updateFunction)

自动更新当前值与结果应用给定的函数，返回更新后的值。函数应该是免费的，因为它可能会被重新应用时尝试更新失败，由于线程之间的争用。

参数

updateFunction -无副作用的功能

结果

更新后的值

从以下版本开始：

一点八

getAndAccumulate

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

自动更新当前值与给定的功能应用到当前和给定值的结果，返回前一个值。函数应该是免费的，因为它可能会被重新应用时尝试更新失败，由于线程之间的争用。函数以当前值作为其第一个参数，并且给出的更新作为第二个参数。

参数

x -更新价值

accumulatorFunction -两参数无副作用的功能

结果

以前的值

从以下版本开始：

一点八

accumulateAndGet

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

自动更新当前值与给定的功能应用到当前和给定值的结果，返回更新后的值。函数应该是免费的，因为它可能会被重新应用时尝试更新失败，由于线程之间的争用。函数以当前值作为其第一个参数，并且给出的更新作为第二个参数。

参数

x -更新价值

accumulatorFunction -两参数无副作用的功能

结果

更新后的值

从以下版本开始：

一点八

toString

public String toString()

返回当前值的字符串表示形式。

重写：

toString 方法重写，继承类 Object

结果

当前值的字符串表示形式