AtomicReferenceFieldUpdater (Java Platform SE 8)

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のほかの呼出しに関してのみ原子性を保証できます。
導入されたバージョン:

1.5

コンストラクタのサマリー

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`AtomicReferenceFieldUpdater()` サブクラスにより使用される、何も行わないprotectedコンストラクタ。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`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(Class<U> tclass, Class<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)` 「現在の値`==`予想される値」である場合、このアップデータが管理する指定されたオブジェクトのフィールド値を、指定された更新済みの値に原子的に設定します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - AtomicReferenceFieldUpdater
```
protected AtomicReferenceFieldUpdater()
```
    サブクラスにより使用される、何も行わないprotectedコンストラクタ。
- メソッドの詳細
  - newUpdater
```
public static <U,W> AtomicReferenceFieldUpdater<U,W> newUpdater(Class<U> tclass,
                                                                Class<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に対するほかの呼出しで原子性を持つことが保証されていますが、フィールド内のほかの変更に関しては必ずしもそうであるとは限りません。
    見かけ上失敗する可能性があり、順序付け保証を提供しないため、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)
```
    このアップデータが管理する指定されたオブジェクトのフィールドを、指定された関数を適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
    
    パラメータ:
    
    obj - フィールドを取得および設定するオブジェクト
    
    updateFunction - 副作用のない関数
    
    戻り値:
    
    前の値
    
    導入されたバージョン:
    
    1.8
  - updateAndGet
```
public final V updateAndGet(T obj,
                            UnaryOperator<V> updateFunction)
```
    このアップデータが管理する指定されたオブジェクトのフィールドを、指定された関数を適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
    
    パラメータ:
    
    obj - フィールドを取得および設定するオブジェクト
    
    updateFunction - 副作用のない関数
    
    戻り値:
    
    更新された値
    
    導入されたバージョン:
    
    1.8
  - getAndAccumulate
```
public final V getAndAccumulate(T obj,
                                V x,
                                BinaryOperator<V> accumulatorFunction)
```
    このアップデータが管理する指定されたオブジェクトのフィールドを、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
    
    パラメータ:
    
    obj - フィールドを取得および設定するオブジェクト
    
    x - 更新値
    
    accumulatorFunction - 2つの引数を取る、副作用のない関数
    
    戻り値:
    
    前の値
    
    導入されたバージョン:
    
    1.8
  - accumulateAndGet
```
public final V accumulateAndGet(T obj,
                                V x,
                                BinaryOperator<V> accumulatorFunction)
```
    このアップデータが管理する指定されたオブジェクトのフィールドを、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
    
    パラメータ:
    
    obj - フィールドを取得および設定するオブジェクト
    
    x - 更新値
    
    accumulatorFunction - 2つの引数を取る、副作用のない関数
    
    戻り値:
    
    更新された値
    
    導入されたバージョン:
    
    1.8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスAtomicReferenceFieldUpdater<T,V>

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

AtomicReferenceFieldUpdater

メソッドの詳細

newUpdater

compareAndSet

weakCompareAndSet

set

lazySet

get

getAndSet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet