java.lang.Object java.util.concurrent.atomic.AtomicMarkableReference<V>
V
- 此引用所引用的对象类型
public class AtomicMarkableReference<V>
AtomicMarkableReference
维护带有标记位的对象引用,可以原子方式对其进行更新。
实现注意事项。通过创建表示“已装箱”的 [reference, boolean] 对的内部对象,此实现维持可标记的引用。
构造方法摘要 | |
---|---|
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 |
构造方法详细信息 |
---|
public AtomicMarkableReference(V initialRef, boolean initialMark)
AtomicMarkableReference
。
initialRef
- 初始引用
initialMark
- 初始标记
方法详细信息 |
---|
public V getReference()
public boolean isMarked()
public V get(boolean[] markHolder)
boolean[1] holder; ref = v.get(holder);
。
markHolder
- 大小至少为 1 的数组。返回时,
markholder[0]
将保存该标记的值。
public boolean weakCompareAndSet(V expectedReference, V newReference, boolean expectedMark, boolean newMark)
==
预期引用,并且当前标记等于预期标记,那么以原子方式将引用和标记的值设置为给定的更新值。
可能意外失败并且不提供排序保证,所以只有在很少的情况下才对 compareAndSet
进行适当地选择。
expectedReference
- 该引用的预期值
newReference
- 该引用的新值
expectedMark
- 该标记的预期值
newMark
- 该标记的新值
public boolean compareAndSet(V expectedReference, V newReference, boolean expectedMark, boolean newMark)
==
预期引用,并且当前标记等于预期标记,那么以原子方式将引用和标记的值设置为给定的更新值。
expectedReference
- 该引用的预期值
newReference
- 该引用的新值
expectedMark
- 该标记的预期值
newMark
- 该标记的新值
public void set(V newReference, boolean newMark)
newReference
- 该引用的新值
newMark
- 该标记的新值
public boolean attemptMark(V expectedReference, boolean newMark)
==
预期引用,则以原子方式将该标记的值设置为给定的更新值。此操作的任何给定调用都可能会意外失败(返回
false
),但是在当前值保持预期值而且没有其他线程也在尝试设置该值时,重复调用将最终获得成功。
expectedReference
- 该引用的预期值
newMark
- 该标记的新值