JavaTM Platform
Standard Ed. 6

java.util.concurrent.atomic
类 AtomicMarkableReference<V>

java.lang.Object
  继承者 java.util.concurrent.atomic.AtomicMarkableReference<V>
类型参数:
V - 此引用所引用的对象类型

public class AtomicMarkableReference<V>
     
extends Object

AtomicMarkableReference 维护带有标记位的对象引用,可以原子方式对其进行更新。

实现注意事项。通过创建表示“已装箱”的 [reference, boolean] 对的内部对象,此实现维持可标记的引用。

从以下版本开始:
1.5

构造方法摘要
AtomicMarkableReference(V initialRef, boolean initialMark)
          创建具有给定初始值的新 AtomicMarkableReference
 
方法摘要
 boolean attemptMark(V expectedReference, boolean newMark)
          如果当前引用 == 预期引用,则以原子方式将该标记的值设置为给定的更新值。
 boolean compareAndSet(V expectedReference, V newReference, boolean expectedMark, boolean newMark)
          如果当前引用 == 预期引用,并且当前标记等于预期标记,那么以原子方式将引用和标记的值设置为给定的更新值。
 V get(boolean[] markHolder)
          返回该引用和该标记的当前值。
 V getReference()
          返回该引用的当前值。
 boolean isMarked()
          返回该标记的当前值。
 void set(V newReference, boolean newMark)
          无条件地同时设置该引用和标记的值。
 boolean weakCompareAndSet(V expectedReference, V newReference, boolean expectedMark, boolean newMark)
          如果当前引用 == 预期引用,并且当前标记等于预期标记,那么以原子方式将引用和标记的值设置为给定的更新值。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

AtomicMarkableReference

public AtomicMarkableReference(V initialRef,
                               boolean initialMark)
创建具有给定初始值的新 AtomicMarkableReference

参数:
initialRef - 初始引用
initialMark - 初始标记
方法详细信息

getReference

public V getReference()
返回该引用的当前值。

返回:
该引用的当前值

isMarked

public boolean isMarked()
返回该标记的当前值。

返回:
该标记的当前值

get

public V get(boolean[] markHolder)
返回该引用和该标记的当前值。典型的用法为 boolean[1] holder; ref = v.get(holder);

参数:
markHolder - 大小至少为 1 的数组。返回时, markholder[0] 将保存该标记的值。
返回:
该引用的当前值

weakCompareAndSet

public boolean weakCompareAndSet(V expectedReference,
                                 V newReference,
                                 boolean expectedMark,
                                 boolean newMark)
如果当前引用 == 预期引用,并且当前标记等于预期标记,那么以原子方式将引用和标记的值设置为给定的更新值。

可能意外失败并且不提供排序保证,所以只有在很少的情况下才对 compareAndSet 进行适当地选择。

参数:
expectedReference - 该引用的预期值
newReference - 该引用的新值
expectedMark - 该标记的预期值
newMark - 该标记的新值
返回:
如果成功,则返回 true

compareAndSet

public boolean compareAndSet(V expectedReference,
                             V newReference,
                             boolean expectedMark,
                             boolean newMark)
如果当前引用 == 预期引用,并且当前标记等于预期标记,那么以原子方式将引用和标记的值设置为给定的更新值。

参数:
expectedReference - 该引用的预期值
newReference - 该引用的新值
expectedMark - 该标记的预期值
newMark - 该标记的新值
返回:
如果成功,则返回 true

set

public void set(V newReference,
                boolean newMark)
无条件地同时设置该引用和标记的值。

参数:
newReference - 该引用的新值
newMark - 该标记的新值

attemptMark

public boolean attemptMark(V expectedReference,
                           boolean newMark)
如果当前引用 == 预期引用,则以原子方式将该标记的值设置为给定的更新值。此操作的任何给定调用都可能会意外失败(返回 false),但是在当前值保持预期值而且没有其他线程也在尝试设置该值时,重复调用将最终获得成功。

参数:
expectedReference - 该引用的预期值
newMark - 该标记的新值
返回:
如果成功,则返回 true

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策