T - 持有可更新字段的对象的类型
V - 字段的类型
public abstract class AtomicReferenceFieldUpdater<T,V> extends Object
volatile volatile引用字段进行原子更新。
该类设计用于原子数据结构，其中同一节点的多个引用字段独立受原子更新。
例如，树节点可能被声明为
class Node { private volatile Node left, right; private static final AtomicReferenceFieldUpdater<Node, Node> leftUpdater = AtomicReferenceFieldUpdater.newUpdater(Node.class, Node.class, "left"); private static AtomicReferenceFieldUpdater<Node, Node> rightUpdater = AtomicReferenceFieldUpdater.newUpdater(Node.class, Node.class, "right"); Node getLeft() { return left; } boolean compareAndSetLeft(Node expect, Node update) { return leftUpdater.compareAndSet(this, expect, update); } // ... and so on }
请注意，该类中compareAndSet方法的保证弱于其他原子类。 因为这个类不能确保该字段的所有用途都适用于原子访问的目的，所以它只能set在相同更新程序上对compareAndSet和set其他调用的compareAndSet 。
| Modifier | Constructor and Description |
|---|---|
protected |
AtomicReferenceFieldUpdater()
受保护的do-nothing构造函数供子类使用。
|
| Modifier and Type | Method and Description |
|---|---|
V |
accumulateAndGet(T obj, V x, BinaryOperator<V> accumulatorFunction)
原子更新由此更新程序管理的给定对象的字段，并将给定函数应用于当前值和给定值，返回更新后的值。
|
abstract boolean |
compareAndSet(T obj, V expect, V update)
如果当前值
==为预期值，则将由此更新程序管理的给定对象的字段原子设置为给定的更新值。
|
abstract V |
get(T obj)
获取由此更新程序管理的给定对象的字段中保留的当前值。
|
V |
getAndAccumulate(T obj, V x, BinaryOperator<V> accumulatorFunction)
原子更新由此更新程序管理的给定对象的字段，并将给定函数应用于当前值和给定值，返回上一个值。
|
V |
getAndSet(T obj, V newValue)
将由此更新程序管理的给定对象的字段原子设置为给定值，并返回旧值。
|
V |
getAndUpdate(T obj, UnaryOperator<V> updateFunction)
使用应用给定函数的结果原子更新由此更新程序管理的给定对象的字段，返回上一个值。
|
abstract void |
lazySet(T obj, V newValue)
最终将由此更新程序管理的给定对象的字段设置为给定的更新值。
|
static <U,W> AtomicReferenceFieldUpdater<U,W> |
newUpdater(类<U> tclass, 类<W> vclass, String fieldName)
创建并返回具有给定字段的对象的更新程序。
|
abstract void |
set(T obj, V newValue)
将由此更新程序管理的给定对象的字段设置为给定的更新值。
|
V |
updateAndGet(T obj, UnaryOperator<V> updateFunction)
原子更新由此更新程序管理的给定对象的字段与应用给定函数的结果，返回更新的值。
|
abstract boolean |
weakCompareAndSet(T obj, V expect, V update)
如果当前值
==为预期值，则将由此更新程序管理的给定对象的字段原子设置为给定的更新值。
|
protected AtomicReferenceFieldUpdater()
public static <U,W> AtomicReferenceFieldUpdater<U,W> newUpdater(类<U> tclass, 类<W> vclass, String fieldName)
U - tclass的实例类型
W - vclass的实例类型
tclass - 持有该字段的对象的类
vclass - 该字段的类
fieldName - 要更新的字段的名称
ClassCastException - 如果字段的类型错误
IllegalArgumentException - 如果该字段不是volatile
RuntimeException - 如果类不保留字段或错误的类型，或者根据Java语言访问控制，该调用者无法访问该字段，则会使用嵌套的基于反射的异常
public abstract boolean compareAndSet(T obj, V expect, V update)
==为预期值，则将由此更新程序管理的给定对象的字段原子设置为给定的更新值。
相对于其他对compareAndSet和set调用，该方法保证是原子的，但不一定与本领域的其他更改相关。
obj - 有条件地设置其字段的对象
expect - 期望值
update - 新价值
true如果成功
public abstract boolean weakCompareAndSet(T obj, V expect, V update)
== ，则将此更新程序管理的给定对象的字段设置为给定的更新值。
相对于其他对compareAndSet和set调用，此方法保证是原子的，但不一定与本领域的其他更改相关。
May fail spuriously and does not provide ordering guarantees ，所以很少适合替代compareAndSet 。
obj - 有条件地设置其字段的对象
expect - 预期值
update - 新的价值
true如果成功
public abstract void set(T obj, V newValue)
compareAndSet 。
obj - 要设置其字段的对象
newValue - 新的价值
public abstract void lazySet(T obj, V newValue)
obj - 要设置其字段的对象
newValue - 新价值
public V getAndSet(T obj, V newValue)
obj - 要获取和设置的字段的对象
newValue - 新的价值
public final V getAndUpdate(T obj, UnaryOperator<V> updateFunction)
obj - 要获取和设置的字段的对象
updateFunction - 无副作用的功能
public final V updateAndGet(T obj, UnaryOperator<V> updateFunction)
obj - 要获取和设置的字段的对象
updateFunction - 无副作用的功能
public final V getAndAccumulate(T obj, V x, BinaryOperator<V> accumulatorFunction)
obj - 要获取和设置的字段的对象
x - 更新值
accumulatorFunction - 两个参数的无效副作用
public final V accumulateAndGet(T obj, V x, BinaryOperator<V> accumulatorFunction)
obj - 要获取和设置的字段的对象
x - 更新值
accumulatorFunction - 两个参数的无副作用函数