AtomicIntegerFieldUpdater (Java Platform SE 8 )

java.lang.Object
- java.util.concurrent.atomic.AtomicIntegerFieldUpdater<T>

参数类型

T - 持有可更新字段的对象的类型
```
public abstract class AtomicIntegerFieldUpdater<T>
extends Object
```
基于反射的实用程序，可以对指定类的指定的volatile int字段进行原子更新。该类设计用于原子数据结构，其中同一节点的多个字段独立受原子更新的影响。
请注意，该类中compareAndSet方法的保证弱于其他原子类。因为这个类不能确保该字段的所有使用都适用于原子访问的目的，所以它可以保证原子性仅在相同更新器上的compareAndSet和set其他调用。

从以下版本开始：

1.5

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`AtomicIntegerFieldUpdater()` 受保护的do-nothing构造函数供子类使用。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`int`	`accumulateAndGet(T obj, int x, IntBinaryOperator accumulatorFunction)` 原子更新由此更新程序管理的给定对象的字段，并将给定函数应用于当前值和给定值，返回更新后的值。
`int`	`addAndGet(T obj, int delta)` 将给定值原子地添加到由此更新程序管理的给定对象的字段的当前值。
`abstract boolean`	`compareAndSet(T obj, int expect, int update)` 如果当前值 `==`为预期值，则将由此更新程序管理的给定对象的字段原子设置为给定的更新值。
`int`	`decrementAndGet(T obj)` 由此更新程序管理的给定对象的字段的当前值原子减1。
`abstract int`	`get(T obj)` 获取由此更新程序管理的给定对象的字段中保留的当前值。
`int`	`getAndAccumulate(T obj, int x, IntBinaryOperator accumulatorFunction)` 原子更新由此更新程序管理的给定对象的字段，并将给定函数应用于当前值和给定值，返回上一个值。
`int`	`getAndAdd(T obj, int delta)` 将给定值原子地添加到由此更新程序管理的给定对象的字段的当前值。
`int`	`getAndDecrement(T obj)` 由此更新程序管理的给定对象的字段的当前值原子减1。
`int`	`getAndIncrement(T obj)` 由此更新程序管理的给定对象的字段的当前值以原子方式递增1。
`int`	`getAndSet(T obj, int newValue)` 将由此更新程序管理的给定对象的字段原子设置为给定值，并返回旧值。
`int`	`getAndUpdate(T obj, IntUnaryOperator updateFunction)` 使用应用给定函数的结果原子更新由此更新程序管理的给定对象的字段，返回上一个值。
`int`	`incrementAndGet(T obj)` 由此更新程序管理的给定对象的字段的当前值以原子方式递增1。
`abstract void`	`lazySet(T obj, int newValue)` 最终将由此更新程序管理的给定对象的字段设置为给定的更新值。
`static <U> AtomicIntegerFieldUpdater<U>`	`newUpdater(类<U> tclass, String fieldName)` 创建并返回具有给定字段的对象的更新程序。
`abstract void`	`set(T obj, int newValue)` 将由此更新程序管理的给定对象的字段设置为给定的更新值。
`int`	`updateAndGet(T obj, IntUnaryOperator updateFunction)` 原子更新由此更新程序管理的给定对象的字段与应用给定函数的结果，返回更新的值。
`abstract boolean`	`weakCompareAndSet(T obj, int expect, int update)` 如果当前值 `==`为预期值，则将由此更新程序管理的给定对象的字段原子设置为给定的更新值。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - AtomicIntegerFieldUpdater
```
protected AtomicIntegerFieldUpdater()
```
    受保护的do-nothing构造函数供子类使用。
- 方法详细信息
  - newUpdater
```
public static <U> AtomicIntegerFieldUpdater<U> newUpdater(类<U> tclass,
                                                          String fieldName)
```
    创建并返回具有给定字段的对象的更新程序。需要Class参数来检查反射类型和泛型类型是否匹配。
    
    参数类型
    
    U - tclass的实例类型
    
    参数
    
    tclass - 持有该字段的对象的类
    
    fieldName - 要更新的字段的名称
    
    结果
    
    更新者
    
    异常
    
    IllegalArgumentException - 如果该字段不是易失性整数类型
    
    RuntimeException - 如果类不保留字段或错误类型，则基于反射的嵌套异常，或者根据Java语言访问控制，调用者无法访问该字段
  - compareAndSet
```
public abstract boolean compareAndSet(T obj,
                                      int expect,
                                      int update)
```
    如果当前值为==由此更新程序管理的给定对象的字段设置为给定的更新值。相对于其他对compareAndSet和set调用，此方法保证是原子的，但不一定与本领域的其他更改相关。
    
    参数
    
    obj - 有条件地设置其字段的对象
    
    expect - 预期值
    
    update - 新价值
    
    结果
    
    true如果成功
    
    异常
    
    ClassCastException - 如果 obj不是具有在构造函数中建立的字段的类的实例
  - weakCompareAndSet
```
public abstract boolean weakCompareAndSet(T obj,
                                          int expect,
                                          int 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,
                         int newValue)
```
    将由此更新程序管理的给定对象的字段设置为给定的更新值。该操作被确保作为一个易失性存储，以便随后调用compareAndSet 。
    
    参数
    
    obj - 要设置的字段的对象
    
    newValue - 新价值
  - lazySet
```
public abstract void lazySet(T obj,
                             int newValue)
```
    最终将由此更新程序管理的给定对象的字段设置为给定的更新值。
    
    参数
    
    obj - 要设置的字段的对象
    
    newValue - 新价值
    
    从以下版本开始：
    
    1.6
  - get
```
public abstract int get(T obj)
```
    获取由此更新程序管理的给定对象的字段中保留的当前值。
    
    参数
    
    obj - 要获取字段的对象
    
    结果
    
    当前值
  - getAndSet
```
public int getAndSet(T obj,
                     int newValue)
```
    将由此更新程序管理的给定对象的字段原子设置为给定值，并返回旧值。
    
    参数
    
    obj - 一个要获取和设置的字段的对象
    
    newValue - 新的价值
    
    结果
    
    以前的值
  - getAndIncrement
```
public int getAndIncrement(T obj)
```
    由此更新程序管理的给定对象的字段的当前值以原子方式递增1。
    
    参数
    
    obj - 要获取和设置的字段的对象
    
    结果
    
    以前的值
  - getAndDecrement
```
public int getAndDecrement(T obj)
```
    由此更新程序管理的给定对象的字段的当前值原子减1。
    
    参数
    
    obj - 一个要获取和设置的字段的对象
    
    结果
    
    以前的值
  - getAndAdd
```
public int getAndAdd(T obj,
                     int delta)
```
    将给定值原子地添加到由此更新程序管理的给定对象的字段的当前值。
    
    参数
    
    obj - 一个要获取和设置的字段的对象
    
    delta - 要添加的值
    
    结果
    
    以前的值
  - incrementAndGet
```
public int incrementAndGet(T obj)
```
    由此更新程序管理的给定对象的字段的当前值以原子方式递增1。
    
    参数
    
    obj - 要获取和设置的字段的对象
    
    结果
    
    更新的值
  - decrementAndGet
```
public int decrementAndGet(T obj)
```
    由此更新程序管理的给定对象的字段的当前值原子减1。
    
    参数
    
    obj - 要获取和设置的字段的对象
    
    结果
    
    更新的值
  - addAndGet
```
public int addAndGet(T obj,
                     int delta)
```
    将给定值原子地添加到由此更新程序管理的给定对象的字段的当前值。
    
    参数
    
    obj - 一个要获取和设置的字段的对象
    
    delta - 要添加的值
    
    结果
    
    更新的值
  - getAndUpdate
```
public final int getAndUpdate(T obj,
                              IntUnaryOperator updateFunction)
```
    使用应用给定函数的结果原子更新由此更新程序管理的给定对象的字段，返回上一个值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
    
    参数
    
    obj - 一个要获取和设置的字段的对象
    
    updateFunction - 无副作用的功能
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - updateAndGet
```
public final int updateAndGet(T obj,
                              IntUnaryOperator updateFunction)
```
    原子更新由此更新程序管理的给定对象的字段与应用给定函数的结果，返回更新的值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
    
    参数
    
    obj - 一个要获取和设置的字段的对象
    
    updateFunction - 无副作用的功能
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - getAndAccumulate
```
public final int getAndAccumulate(T obj,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)
```
    原子更新由此更新程序管理的给定对象的字段，并将给定函数应用于当前值和给定值，返回上一个值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。
    
    参数
    
    obj - 一个要获取和设置的字段的对象
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无效副作用
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - accumulateAndGet
```
public final int accumulateAndGet(T obj,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)
```
    原子更新由此更新程序管理的给定对象的字段，并将给定函数应用于当前值和给定值，返回更新后的值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。
    
    参数
    
    obj - 要获取和设置的字段的对象
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无副作用的函数
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8

Class AtomicIntegerFieldUpdater<T>

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

AtomicIntegerFieldUpdater

方法详细信息

newUpdater

compareAndSet

weakCompareAndSet

set

lazySet

get

getAndSet

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet