compact1、compact2、compact3

java.util.concurrent.atomic

クラスAtomicReference<V>

java.lang.Object

java.util.concurrent.atomic.AtomicReference<V>

型パラメータ:

V - この参照により参照されるオブジェクトの型

すべての実装されたインタフェース:

Serializable

public class AtomicReference<V>
extends Object
implements Serializable

原子的な更新が可能なオブジェクト参照です。原子変数のプロパティの詳細は、java.util.concurrent.atomicパッケージ仕様を参照してください。

導入されたバージョン:

1.5

関連項目:

直列化された形式

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

コンストラクタ

コンストラクタと説明
AtomicReference() 初期値nullを使って、新しいAtomicReferenceを作成します。
AtomicReference(V initialValue) 指定された初期パラメータを使って、新しいAtomicReferenceを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
V	accumulateAndGet(V x, BinaryOperator<V> accumulatorFunction) 現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。
boolean	compareAndSet(V expect, V update) 「現在の値==予想される値」である場合、値を指定された更新値に原子的に設定します。
V	get() 現在の値を取得します。
V	getAndAccumulate(V x, BinaryOperator<V> accumulatorFunction) 現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。
V	getAndSet(V newValue) 指定された値に原子的に設定して、以前の値を返します。
V	getAndUpdate(UnaryOperator<V> updateFunction) 現在の値を、指定された関数を適用した結果で原子的に更新し、前の値を返します。
void	lazySet(V newValue) 指定された値に最終的に設定します。
void	set(V newValue) 指定された値に設定します。
String	toString() 現在値の文字列表記を返します。
V	updateAndGet(UnaryOperator<V> updateFunction) 現在の値を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。
boolean	weakCompareAndSet(V expect, V update) 「現在の値==予想される値」である場合、値を指定された更新値に原子的に設定します。

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

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

コンストラクタの詳細

AtomicReference

public AtomicReference(V initialValue)

指定された初期パラメータを使って、新しいAtomicReferenceを作成します。

パラメータ:

initialValue - 初期値

AtomicReference

public AtomicReference()

初期値nullを使って、新しいAtomicReferenceを作成します。

メソッドの詳細

get

public final V get()

現在の値を取得します。

戻り値:

現行値

set

public final void set(V newValue)

指定された値に設定します。

パラメータ:

newValue - 新しい値

lazySet

public final void lazySet(V newValue)

指定された値に最終的に設定します。

パラメータ:

newValue - 新しい値

導入されたバージョン:

1.6

compareAndSet

public final boolean compareAndSet(V expect,
                                   V update)

「現在の値==予想される値」である場合、値を指定された更新値に原子的に設定します。

パラメータ:

expect - 予想される値

update - 新しい値

戻り値:

成功する場合はtrue。falseは、実際の値が予想される値と等価ではないことを示す。

weakCompareAndSet

public final boolean weakCompareAndSet(V expect,
                                       V update)

「現在の値==予想される値」である場合、値を指定された更新値に原子的に設定します。

見かけ上失敗する可能性があり、順序付け保証を提供しないため、compareAndSetの代わりに使用することはほとんどありません。

パラメータ:

expect - 予想される値

update - 新しい値

戻り値:

成功した場合はtrue

getAndSet

public final V getAndSet(V newValue)

指定された値に原子的に設定して、以前の値を返します。

パラメータ:

newValue - 新しい値

戻り値:

前の値

getAndUpdate

public final V getAndUpdate(UnaryOperator<V> updateFunction)

現在の値を、指定された関数を適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。

パラメータ:

updateFunction - 副作用のない関数

戻り値:

前の値

導入されたバージョン:

1.8

updateAndGet

public final V updateAndGet(UnaryOperator<V> updateFunction)

現在の値を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。

パラメータ:

updateFunction - 副作用のない関数

戻り値:

更新された値

導入されたバージョン:

1.8

getAndAccumulate

public final V getAndAccumulate(V x,
                                BinaryOperator<V> accumulatorFunction)

現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。

パラメータ:

x - 更新値

accumulatorFunction - 2つの引数を取る、副作用のない関数

戻り値:

前の値

導入されたバージョン:

1.8

accumulateAndGet

public final V accumulateAndGet(V x,
                                BinaryOperator<V> accumulatorFunction)

現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。

パラメータ:

x - 更新値

accumulatorFunction - 2つの引数を取る、副作用のない関数

戻り値:

更新された値

導入されたバージョン:

1.8

toString

public String toString()

現在値の文字列表記を返します。

オーバーライド:

toString、クラス: Object

戻り値:

現在値の文字列表現。