モジュール java.base

パッケージ java.util.concurrent.atomic

クラスAtomicStampedReference<V>

java.lang.Object

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

型パラメータ:

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

public class AtomicStampedReference<V> extends Object

AtomicStampedReferenceは、原子的に更新可能な整数「スタンプ」とともに、オブジェクト参照を管理します。

実装にあたってのノート: この実装は、括弧で囲まれた[参照、整数]のペアを表す内部オブジェクトを作成することにより、スタンプされた参照を維持します。

導入されたバージョン:

1.5

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

コンストラクタ

コンストラクタ	説明
AtomicStampedReference(V initialRef, int initialStamp)	指定された初期値を使って、新しいAtomicStampedReferenceを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
boolean	attemptStamp(V expectedReference, int newStamp)	「現在の参照==予想される参照」である場合は、スタンプの値を指定された更新値に原子的に設定します。
boolean	compareAndSet(V expectedReference, V newReference, int expectedStamp, int newStamp)	「現在の参照==予想される参照」であり、現在のスタンプが予想されるスタンプに等しい場合、参照およびスタンプの値を指定された更新値に原子的に設定します。
V	get(int[] stampHolder)	参照およびスタンプの現在値を返します。
V	getReference()	参照の現在値を返します。
int	getStamp()	スタンプの現在値を返します。
void	set(V newReference, int newStamp)	参照およびスタンプの値を無条件に設定します。
boolean	weakCompareAndSet(V expectedReference, V newReference, int expectedStamp, int newStamp)	「現在の参照==予想される参照」であり、現在のスタンプが予想されるスタンプに等しい場合、参照およびスタンプの値を指定された更新値に原子的に設定します。

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

AtomicStampedReference

public AtomicStampedReference(V initialRef, int initialStamp)

指定された初期値を使って、新しいAtomicStampedReferenceを作成します。

パラメータ:

initialRef - 初期参照

initialStamp - 初期スタンプ

メソッドの詳細

getReference

public V getReference()

参照の現在値を返します。

戻り値:

参照の現在値

getStamp

public int getStamp()

スタンプの現在値を返します。

戻り値:

スタンプの現在値

get

public V get(int[] stampHolder)

参照およびスタンプの現在値を返します。 通常の使用法はint[1] holder; ref = v.get(holder); です。

パラメータ:

stampHolder - 1以上のサイズの配列。 戻り値の場合、stampHolder[0]はスタンプの値を保持します。

戻り値:

参照の現在値

weakCompareAndSet

public boolean weakCompareAndSet(V expectedReference, V newReference, int expectedStamp, int newStamp)

「現在の参照==予想される参照」であり、現在のスタンプが予想されるスタンプに等しい場合、参照およびスタンプの値を指定された更新値に原子的に設定します。 この操作は誤って失敗する可能性があり、順序付けの保証は提供されないため、compareAndSetのかわりに適したものになることはほとんどありません。

パラメータ:

expectedReference - 参照の予想される値

newReference - 参照の新しい値

expectedStamp - スタンプの予想される値

newStamp - スタンプの新しい値

戻り値:

成功した場合はtrue

compareAndSet

public boolean compareAndSet(V expectedReference, V newReference, int expectedStamp, int newStamp)

「現在の参照==予想される参照」であり、現在のスタンプが予想されるスタンプに等しい場合、参照およびスタンプの値を指定された更新値に原子的に設定します。

パラメータ:

expectedReference - 参照の予想される値

newReference - 参照の新しい値

expectedStamp - スタンプの予想される値

newStamp - スタンプの新しい値

戻り値:

成功した場合はtrue

set

public void set(V newReference, int newStamp)

参照およびスタンプの値を無条件に設定します。

パラメータ:

newReference - 参照の新しい値

newStamp - スタンプの新しい値

attemptStamp

public boolean attemptStamp(V expectedReference, int newStamp)

「現在の参照==予想される参照」である場合は、スタンプの値を指定された更新値に原子的に設定します。 この操作の指定された呼出しはすべて、見かけ上失敗する(falseを返す)可能性があります。ただし、現在の値が予想される値を保持し、値の設定を試みるほかのスレッドが存在しない場合は、呼出しが繰り返されることで最終的に成功します。

パラメータ:

expectedReference - 参照の予想される値

newStamp - スタンプの新しい値

戻り値:

成功した場合はtrue