compact1, compact2, compact3

java.util.concurrent.atomic

Class AtomicStampedReference<V>

java.lang.Object

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

参数类型

V -对象的类型称为参考

public class AtomicStampedReference<V>
extends Object

一个 AtomicStampedReference保持随着整数“邮票”一个对象的引用，可以自动更新。

实现说明：此实现通过创建表示“框”[参考，整数]对的内部对象来保持标记的引用。

从以下版本开始：

一点五

构造方法摘要

构造方法

Constructor and Description
AtomicStampedReference(V initialRef, int initialStamp) 创建具有给定的初始值的一个新的 AtomicStampedReference。

方法摘要

Modifier and Type	Method and Description
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) 自动设置的参考和印花的更新值，如果电流参考 ==预计参考目前印花等于预期的邮票。

Methods inherited from class java.lang.Object

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

Constructor Detail

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 -至少一个大小的数组。返回时， stampholder[0]将邮票的价值。

结果

参考的当前值

weakCompareAndSet

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

自动设置的参考和印花的更新值，如果电流参考 ==预计参考目前印花等于预期的邮票。

May fail spuriously and does not provide ordering guarantees，所以很少有合适的替代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如果成功