java.util.concurrent.atomic

Класс AtomicStampedReference <V>

java.lang. Объект

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 унаследованный от класса. Объект

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()

Возвращает текущую стоимость штампа.

Возвраты:

текущая стоимость штампа

добраться

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)

Атомарно устанавливает значение обоих ссылка и штамп к данным значениям обновления, если текущая ссылка == к ожидаемой ссылке и текущему штампу равно ожидаемому штампу.

Может перестать работать побочно и не обеспечивает гарантии упорядочивания, так только редко соответствующая альтернатива compareAndSet.

Параметры:

expectedReference - математическое ожидание ссылки

newReference - новое значение для ссылки

expectedStamp - математическое ожидание штампа

newStamp - новое значение для штампа

Возвраты:

истина в случае успеха

compareAndSet

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

Атомарно устанавливает значение обоих ссылка и штамп к данным значениям обновления, если текущая ссылка == к ожидаемой ссылке и текущему штампу равно ожидаемому штампу.

Параметры:

expectedReference - математическое ожидание ссылки

newReference - новое значение для ссылки

expectedStamp - математическое ожидание штампа

newStamp - новое значение для штампа

Возвраты:

истина в случае успеха

набор

public void set(V newReference,
       int newStamp)

Безоговорочно устанавливает значение обоих ссылка и штамп.

Параметры:

newReference - новое значение для ссылки

newStamp - новое значение для штампа

attemptStamp

public boolean attemptStamp(V expectedReference,
                   int newStamp)

Атомарно устанавливает значение штампа к данному значению обновления, если текущая ссылка == к ожидаемой ссылке. Любой данный вызов этой работы может перестать работать (возврат false) побочно, но повторенный вызов, когда текущая стоимость содержит математическое ожидание и никакой другой поток, также пытается установить значение, в конечном счете успешно выполнится.

Параметры:

expectedReference - математическое ожидание ссылки

newStamp - новое значение для штампа

Возвраты:

истина в случае успеха