compact1, compact2, compact3

java.util.concurrent.atomic

Class AtomicLongFieldUpdater<T>

java.lang.Object

java.util.concurrent.atomic.AtomicLongFieldUpdater<T>

参数类型

T -客体可更新的字段的类型

public abstract class AtomicLongFieldUpdater<T>
extends Object

一种基于反射的效用，使原子更新指定 volatile long字段指定的类。此类被设计用于原子数据结构中，在该结构中，同一节点的几个字段独立地受原子更新。

值得注意的是，在这类的compareAndSet方法保证弱于其他原子类。因为这类不能确保所有的字段都适合原子访问的目的，它可以保证原子性只有在同一更新相对于compareAndSet和set其他调用。

从以下版本开始：

一点五

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	AtomicLongFieldUpdater() 受保护的无构造函数使用的子类。

方法摘要

Modifier and Type	Method and Description
long	accumulateAndGet(T obj, long x, LongBinaryOperator accumulatorFunction) 自动更新给定对象的更新管理与应用给出的函数的电流与给定值结果领域，返回更新后的值。
long	addAndGet(T obj, long delta) 自动添加给定值对给定对象的更新管理领域的当前值。
abstract boolean	compareAndSet(T obj, long expect, long update) 自动设置给定对象的这个更新设法给出更新的价值领域如果电流值 ==期望值。
long	decrementAndGet(T obj) 自动递减一个给定对象的更新管理这一领域目前的价值。
abstract long	get(T obj) 获取当前值在给定对象的更新管理领域举行。
long	getAndAccumulate(T obj, long x, LongBinaryOperator accumulatorFunction) 自动更新给定对象的更新管理与应用给出的函数的电流与给定值结果领域，返回前一个值。
long	getAndAdd(T obj, long delta) 自动添加给定值对给定对象的更新管理领域的当前值。
long	getAndDecrement(T obj) 自动递减一个给定对象的更新管理这一领域目前的价值。
long	getAndIncrement(T obj) 自动递增一个给定对象的更新管理这一领域目前的价值。
long	getAndSet(T obj, long newValue) 自动设置现场给定对象的更新管理给定的值并返回旧值。
long	getAndUpdate(T obj, LongUnaryOperator updateFunction) 自动更新领域的给定对象的更新管理与应用结果给定的函数，返回前一个值。
long	incrementAndGet(T obj) 自动递增一个给定对象的更新管理这一领域目前的价值。
abstract void	lazySet(T obj, long newValue) 最终设置给定对象的更新设法给出更新的价值领域。
static <U> AtomicLongFieldUpdater<U>	newUpdater(类<U> tclass, String fieldName) 创建并返回与给定的领域对象的更新。
abstract void	set(T obj, long newValue) 设置给定对象的更新设法给出更新的价值领域。
long	updateAndGet(T obj, LongUnaryOperator updateFunction) 自动更新领域的给定对象的更新管理与应用结果给定的函数，返回更新后的值。
abstract boolean	weakCompareAndSet(T obj, long expect, long update) 自动设置给定对象的这个更新设法给出更新的价值领域如果电流值 ==期望值。

Methods inherited from class java.lang.Object

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

Constructor Detail

AtomicLongFieldUpdater

protected AtomicLongFieldUpdater()

受保护的无构造函数使用的子类。

方法详细信息

newUpdater

public static <U> AtomicLongFieldUpdater<U> newUpdater(类<U> tclass,
                                                       String fieldName)

创建并返回与给定的领域对象的更新。类的参数是必要的，以检查反射类型和泛型类型的匹配。

参数类型

U -实例类型TClass

参数

tclass -控股的领域对象的类

fieldName -字段的名字被更新

结果

更新

异常

IllegalArgumentException如果字段不挥发性的长型

RuntimeException -嵌套的基于反射的异常，如果类没有场或是错误的类型，或该领域无法调用java语言根据访问控制

compareAndSet

public abstract boolean compareAndSet(T obj,
                                      long expect,
                                      long update)

自动设置给定对象的这个更新设法给出更新的价值领域如果电流值 ==期望值。这种方法可以保证原子相对于其他呼叫 compareAndSet和 set，但不一定就在该领域的其他变化。

参数

obj -一个对象的字段条件设置

expect -期望值

update -新价值

结果

true如果成功

异常

ClassCastException -如果 obj不是类的构造函数中建立具有现场实例

weakCompareAndSet

public abstract boolean weakCompareAndSet(T obj,
                                          long expect,
                                          long update)

自动设置给定对象的这个更新设法给出更新的价值领域如果电流值 ==期望值。这种方法可以保证原子相对于其他呼叫 compareAndSet和 set，但不一定就在该领域的其他变化。

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

参数

obj -一个对象的字段条件设置

expect -期望值

update -新价值

结果

true如果成功

异常

ClassCastException -如果 obj不是类的构造函数中建立具有现场实例

set

public abstract void set(T obj,
                         long newValue)

设置给定对象的更新设法给出更新的价值领域。这个操作是保证作为一个与随后的调用 compareAndSet挥发性存储。

参数

obj -一个对象的域设置

newValue -新价值

lazySet

public abstract void lazySet(T obj,
                             long newValue)

最终设置给定对象的更新设法给出更新的价值领域。

参数

obj -一个对象的域设置

newValue -新价值

从以下版本开始：

一点六

get

public abstract long get(T obj)

获取当前值在给定对象的更新管理领域举行。

参数

obj -一个对象的领域有

结果

目前的价值

getAndSet

public long getAndSet(T obj,
                      long newValue)

自动设置现场给定对象的更新管理给定的值并返回旧值。

参数

obj -一个对象的字段来获取和设置

newValue -新价值

结果

以前的值

getAndIncrement

public long getAndIncrement(T obj)

自动递增一个给定对象的更新管理这一领域目前的价值。

参数

obj -一个对象的字段来获取和设置

结果

以前的值

getAndDecrement

public long getAndDecrement(T obj)

自动递减一个给定对象的更新管理这一领域目前的价值。

参数

obj -一个对象的字段来获取和设置

结果

以前的值

getAndAdd

public long getAndAdd(T obj,
                      long delta)

自动添加给定值对给定对象的更新管理领域的当前值。

参数

obj -一个对象的字段来获取和设置

delta -价值增加

结果

以前的值

incrementAndGet

public long incrementAndGet(T obj)

自动递增一个给定对象的更新管理这一领域目前的价值。

参数

obj -一个对象的字段来获取和设置

结果

更新后的值

decrementAndGet

public long decrementAndGet(T obj)

自动递减一个给定对象的更新管理这一领域目前的价值。

参数

obj -一个对象的字段来获取和设置

结果

更新后的值

addAndGet

public long addAndGet(T obj,
                      long delta)

自动添加给定值对给定对象的更新管理领域的当前值。

参数

obj -一个对象的字段来获取和设置

delta -价值增加

结果

更新后的值

getAndUpdate

public final long getAndUpdate(T obj,
                               LongUnaryOperator updateFunction)

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

参数

obj -一个对象的字段来获取和设置

updateFunction -无副作用的功能

结果

以前的值

从以下版本开始：

一点八

updateAndGet

public final long updateAndGet(T obj,
                               LongUnaryOperator updateFunction)

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

参数

obj -一个对象的字段来获取和设置

updateFunction -无副作用的功能

结果

更新后的值

从以下版本开始：

一点八

getAndAccumulate

public final long getAndAccumulate(T obj,
                                   long x,
                                   LongBinaryOperator accumulatorFunction)

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

参数

obj -一个对象的字段来获取和设置

x -更新价值

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

结果

以前的值

从以下版本开始：

一点八

accumulateAndGet

public final long accumulateAndGet(T obj,
                                   long x,
                                   LongBinaryOperator accumulatorFunction)

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

参数

obj -一个对象的字段来获取和设置

x -更新价值

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

结果

更新后的值

从以下版本开始：

一点八