java.util.concurrent.atomic

Класс AtomicReferenceFieldUpdater <T, V>

java.lang. Объект

java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T,V>

Введите Параметры:

T - Тип объекта, содержащего обновляемое поле

V - Тип поля

public abstract class AtomicReferenceFieldUpdater<T,V>
extends Object

Основанная на отражении утилита, которая включает атомарным обновлениям к определяемому volatile ссылочные поля определяемых классов. Этот класс разрабатывается для использования в атомарных структурах данных, в которых несколько ссылочных полей того же самого узла независимо подвергаются атомарным обновлениям. Например, древовидный узел мог бы быть объявлен как

 class Node {
   private volatile Node left, right;

   private static final AtomicReferenceFieldUpdater<Node, Node> leftUpdater =
     AtomicReferenceFieldUpdater.newUpdater(Node.class, Node.class, "left");
   private static AtomicReferenceFieldUpdater<Node, Node> rightUpdater =
     AtomicReferenceFieldUpdater.newUpdater(Node.class, Node.class, "right");

   Node getLeft() { return left;  }
   boolean compareAndSetLeft(Node expect, Node update) {
     return leftUpdater.compareAndSet(this, expect, update);
   }
   // ... and so on
 }

Отметьте что гарантии compareAndSet метод в этом классе более слаб чем в других атомарных классах. Поскольку этот класс не может гарантировать, что все использование поля является соответствующим в целях атомарного доступа, это может гарантировать атомарность только относительно других вызовов compareAndSet и set на том же самом updater.

С тех пор:

1.5

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	AtomicReferenceFieldUpdater() Защищенный пустой конструктор для использования подклассами.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
abstract boolean	compareAndSet(T obj, V expect, V update) Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость == математическое ожидание.
abstract V	get(T obj) Содержали текущую стоимость в поле данного объекта, которым управляет этот updater.
V	getAndSet(T obj, V newValue) Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному значению, и возвращает старое значение.
abstract void	lazySet(T obj, V newValue) В конечном счете устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению.
static <U,W> AtomicReferenceFieldUpdater<U,W>	newUpdater(Class<U> tclass, Class<W> vclass, String fieldName) Создает и возвращает updater для объектов с данным полем.
abstract void	set(T obj, V newValue) Устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению.
abstract boolean	weakCompareAndSet(T obj, V expect, V update) Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость == математическое ожидание.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

AtomicReferenceFieldUpdater

protected AtomicReferenceFieldUpdater()

Защищенный пустой конструктор для использования подклассами.

Деталь метода

newUpdater

public static <U,W> AtomicReferenceFieldUpdater<U,W> newUpdater(Class<U> tclass,
                                                Class<W> vclass,
                                                String fieldName)

Создает и возвращает updater для объектов с данным полем. Параметры Класса необходимы, чтобы проверить, что отражающие типы и универсальные типы соответствуют.

Параметры:

tclass - класс удерживающих позиции объектов.

vclass - класс поля

fieldName - имя поля, которое будет обновлено.

Возвраты:

updater

Броски:

IllegalArgumentException - если поле не является энергозависимым ссылочным типом.

RuntimeException - с вложенным основанным на отражении исключением, если класс не содержит поле или является неправильным типом.

compareAndSet

public abstract boolean compareAndSet(T obj,
                    V expect,
                    V update)

Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость == математическое ожидание. Этот метод, как гарантируют, будет атомарным относительно других звонков compareAndSet и set, но не обязательно относительно других изменений в поле.

Параметры:

obj - Объект, чье поле, чтобы условно установить

expect - математическое ожидание

update - новое значение

Возвраты:

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

weakCompareAndSet

public abstract boolean weakCompareAndSet(T obj,
                        V expect,
                        V update)

Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость == математическое ожидание. Этот метод, как гарантируют, будет атомарным относительно других звонков compareAndSet и set, но не обязательно относительно других изменений в поле.

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

Параметры:

obj - Объект, чье поле, чтобы условно установить

expect - математическое ожидание

update - новое значение

Возвраты:

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

набор

public abstract void set(T obj,
       V newValue)

Устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению. Эта работа, как гарантируют, будет действовать как энергозависимое хранилище относительно последующих вызовов compareAndSet.

Параметры:

obj - Объект, чье поле, чтобы установить

newValue - новое значение

lazySet

public abstract void lazySet(T obj,
           V newValue)

В конечном счете устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению.

Параметры:

obj - Объект, чье поле, чтобы установить

newValue - новое значение

С тех пор:

1.6

добраться

public abstract V get(T obj)

Содержали текущую стоимость в поле данного объекта, которым управляет этот updater.

Параметры:

obj - Объект, чье поле, чтобы добраться

Возвраты:

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

getAndSet

public V getAndSet(T obj,
          V newValue)

Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному значению, и возвращает старое значение.

Параметры:

obj - Объект, чье поле, чтобы добраться и установить

newValue - новое значение

Возвраты:

предыдущее значение