Класс AtomicMarkableReference<V>

java.lang.Object
- java.util.concurrent.atomic.AtomicMarkableReference<V>

Параметры типа:: V - Тип объекта, на который указывает эта ссылка

public class AtomicMarkableReference<V>
extends Object

Класс AtomicMarkableReference поддерживает ссылку на объект вместе с битом метки, которые могут быть изменены атомарно.

Примечание об реализации: эта реализация поддерживает метки ссылок, создавая внутренние объекты, представляющие пары [ссылка, булево значение].

С тех пор:: 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 - массив размером как минимум один. По возвращении 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 при успехе