java.lang.Object
- java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T,V>

参数类型

T - 包含可更新字段的对象的类型

V - 字段的类型
```
public abstract class AtomicReferenceFieldUpdater<T,V>
extends Object
```
基于反射的实用程序，可以对指定类的指定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方法的保证比其他原子类弱。由于此类无法确保该字段的所有使用都适用于原子访问，因此只能在同一更新程序上对compareAndSet和set其他调用保证原子性。

T类型的参数的对象参数不是传递给newUpdater(java.lang.Class<U>, java.lang.Class<W>, java.lang.String)的类的实例，将导致抛出ClassCastException 。
从以下版本开始：

1.5

构造方法摘要

构造方法

变量构造器描述

protected AtomicReferenceFieldUpdater()
受保护的无操作构造函数供子类使用。

方法摘要

所有方法静态方法实例方法抽象方法具体的方法
变量和类型	方法	描述
`V`	`accumulateAndGet(T obj, V x, BinaryOperator<V> accumulatorFunction)`	原子更新（具有由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）由此更新程序管理的给定对象的字段，以及将给定函数应用于当前值和给定值的结果，返回更新的值。
`abstract boolean`	`compareAndSet(T obj, V expect, V update)`	如果当前值为 `==` ，则以原子方式将此更新程序管理的给定对象的字段设置为给定的更新值。
`abstract V`	`get(T obj)`	返回此更新程序管理的给定对象的字段中保存的当前值。
`V`	`getAndAccumulate(T obj, V x, BinaryOperator<V> accumulatorFunction)`	原子更新（由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）由此更新程序管理的给定对象的字段，以及将给定函数应用于当前值和给定值的结果，返回先前的值。
`V`	`getAndSet(T obj, V newValue)`	以原子方式将此更新程序管理的给定对象的字段设置为给定值，并返回旧值。
`V`	`getAndUpdate(T obj, UnaryOperator<V> updateFunction)`	原子地更新（具有由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）由此更新程序管理的给定对象的字段以及应用给定函数的结果，返回先前的值。
`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)`	原子地更新（具有由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）由此更新程序管理的给定对象的字段以及应用给定函数的结果，返回更新的值。
`abstract boolean`	`weakCompareAndSet(T obj, V expect, V update)`	如果当前值 `==`是预期值， `==`原子方式将此更新程序管理的给定对象的字段设置为给定的更新值。

声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - AtomicReferenceFieldUpdater
```
protected AtomicReferenceFieldUpdater()
```
    受保护的无操作构造函数供子类使用。
- 方法详细信息
  - newUpdater
```
public static <U,W> AtomicReferenceFieldUpdater<U,W> newUpdater(类<U> tclass,
                                                                            类<W> vclass,
                                                                            String fieldName)
```
    为具有给定字段的对象创建并返回更新程序。需要Class参数来检查反射类型和泛型类型是否匹配。
    
    参数类型
    
    U - tclass实例的类型
    
    W - vclass实例的类型
    
    参数
    
    tclass - 包含该字段的对象的类
    
    vclass - 该字段的类
    
    fieldName - 要更新的字段的名称
    
    结果
    
    更新者
    
    异常
    
    ClassCastException - 如果字段类型错误
    
    IllegalArgumentException - 如果该字段不是易变的
    
    RuntimeException - 如果类不包含字段或类型错误，则使用嵌套的基于反射的异常，或者根据Java语言访问控制，调用方无法访问该字段
  - compareAndSet
```
public abstract boolean compareAndSet(T obj,
                                      V expect,
                                      V update)
```
    如果当前值==是预期值， ==原子方式将此更新程序管理的给定对象的字段设置为给定的更新值。相对于对compareAndSet和set其他调用，此方法保证是原子的，但不一定与该字段中的其他更改相关。
    
    参数
    
    obj - 要有条件地设置其字段的对象
    
    expect - 期望值
    
    update - 新值
    
    结果
    
    true如果成功
  - weakCompareAndSet
```
public abstract boolean weakCompareAndSet(T obj,
                                          V expect,
                                          V update)
```
    如果当前值==是预期值， ==原子方式将此更新程序管理的给定对象的字段设置为给定的更新值。相对于对compareAndSet和set其他调用，此方法保证是原子的，但不一定与该字段中的其他更改相关。
    May fail spuriously and does not provide ordering guarantees ，所以很少是compareAndSet的合适替代compareAndSet 。
    
    参数
    
    obj - 要有条件地设置其字段的对象
    
    expect - 预期值
    
    update - 新值
    
    结果
    
    true如果成功
  - set
```
public abstract void set(T obj,
                         V newValue)
```
    将此更新程序管理的给定对象的字段设置为给定的更新值。保证此操作在后续调用compareAndSet充当易失性存储。
    
    参数
    
    obj - 要设置其字段的对象
    
    newValue - 新值
  - lazySet
```
public abstract void lazySet(T obj,
                             V newValue)
```
    最终将此更新程序管理的给定对象的字段设置为给定的更新值。
    
    参数
    
    obj - 要设置其字段的对象
    
    newValue - 新值
    
    从以下版本开始：
    
    1.6
  - get
```
public abstract V get(T obj)
```
    返回此更新程序管理的给定对象的字段中保存的当前值。
    
    参数
    
    obj - 要获取其字段的对象
    
    结果
    
    当前的价值
  - getAndSet
```
public V getAndSet(T obj,
                   V newValue)
```
    以原子方式将此更新程序管理的给定对象的字段设置为给定值，并返回旧值。
    
    参数
    
    obj - 要获取和设置其字段的对象
    
    newValue - 新值
    
    结果
    
    以前的值
  - getAndUpdate
```
public final V getAndUpdate(T obj,
                            UnaryOperator<V> updateFunction)
```
    原子地更新（具有由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）由此更新程序管理的给定对象的字段以及应用给定函数的结果，返回先前的值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。
    
    参数
    
    obj - 要获取和设置其字段的对象
    
    updateFunction - 无副作用的功能
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - updateAndGet
```
public final V updateAndGet(T obj,
                            UnaryOperator<V> updateFunction)
```
    原子地更新（具有由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）由此更新程序管理的给定对象的字段以及应用给定函数的结果，返回更新的值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。
    
    参数
    
    obj - 要获取和设置其字段的对象
    
    updateFunction - 无副作用的功能
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - getAndAccumulate
```
public final V getAndAccumulate(T obj,
                                V x,
                                BinaryOperator<V> accumulatorFunction)
```
    原子更新（由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）由此更新程序管理的给定对象的字段，以及将给定函数应用于当前值和给定值的结果，返回先前的值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。该函数应用当前值作为其第一个参数，并将给定更新作为第二个参数。
    
    参数
    
    obj - 要获取和设置其字段的对象
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无副作用函数
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - accumulateAndGet
```
public final V accumulateAndGet(T obj,
                                V x,
                                BinaryOperator<V> accumulatorFunction)
```
    原子更新（具有由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）由此更新程序管理的给定对象的字段，以及将给定函数应用于当前值和给定值的结果，返回更新的值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。该函数应用当前值作为其第一个参数，并将给定更新作为第二个参数。
    
    参数
    
    obj - 要获取和设置其字段的对象
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无副作用函数
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8

Class AtomicReferenceFieldUpdater<T,​V>

构造方法摘要

方法摘要

声明方法的类 java.lang.Object

构造方法详细信息

AtomicReferenceFieldUpdater

方法详细信息

newUpdater

compareAndSet

weakCompareAndSet

set

lazySet

get

getAndSet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet

Class AtomicReferenceFieldUpdater<T,V>