- 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)
如果当前值==
是预期值,==
原子方式将此更新程序管理的给定对象的字段设置为给定的更新值。
-
-
-
方法详细信息
-
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
-
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
-
-