AtomicReferenceFieldUpdater (Платформа Java SE 8 b92)

java.lang. Объект
- java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T,V>

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

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

V - Тип поля
```
public abstract class AtomicReferenceFieldUpdater<T,V>
extends Object
```
Основанная на отражении утилита, которая включает атомарным обновлениям к определяемому volatile ссылочные поля определяемых классов. Этот class разрабатывается для использования в атомарных структурах данных, в которых несколько ссылочных полей того же самого узла независимо подвергаются атомарным обновлениям. Например, древовидный узел мог бы быть объявлен как
```
 
 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 метод в этом class более слаб чем в других атомарных классах. Поскольку этот class не может гарантировать, что все использование поля является соответствующим в целях атомарного доступа, это может гарантировать атомарность только относительно других вызовов compareAndSet и set на том же самом updater.
С тех пор:

1.5

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

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

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

Все Методы Статические Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`V`	`accumulateAndGet(T obj, V x, BinaryOperator<V> accumulatorFunction)` Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая обновленное значение.
`abstract boolean`	`compareAndSet(T obj, V expect, V update)` Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость `==` математическое ожидание.
`abstract V`	`get(T obj)` Содержали текущую стоимость в поле данного объекта, которым управляет этот updater.
`V`	`getAndAccumulate(T obj, V x, BinaryOperator<V> accumulatorFunction)` Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая предыдущее значение.
`V`	`getAndSet(T obj, V newValue)` Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному значению, и возвращает старое значение.
`V`	`getAndUpdate(T obj, UnaryOperator<V> updateFunction)` Атомарно обновляет поле данного объекта, которым управляет этот 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 к данному обновленному значению.
`V`	`updateAndGet(T obj, UnaryOperator<V> updateFunction)` Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции, возвращая обновленное значение.
`abstract boolean`	`weakCompareAndSet(T obj, V expect, V update)` Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость `==` математическое ожидание.

Методы, наследованные от class 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 - class удерживающих позиции объектов.
    
    vclass - class поля
    
    fieldName - имя поля, которое будет обновлено.
    
    Возвраты:
    
    updater
    
    Броски:
    
    IllegalArgumentException - если поле не является энергозависимым ссылочным типом.
    
    RuntimeException - с вложенным основанным на отражении исключением, если class не содержит поле или является неправильным типом, или поле недоступно вызывающей стороне согласно управлению доступом языка Java
  - 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 - новое значение
    
    Возвраты:
    
    предыдущее значение
  - getAndUpdate
```
public final V getAndUpdate(T obj,
                            UnaryOperator<V> updateFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции, возвращая предыдущее значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    updateFunction - функция без побочных эффектов
    
    Возвраты:
    
    предыдущее значение
    
    С тех пор:
    
    1.8
  - updateAndGet
```
public final V updateAndGet(T obj,
                            UnaryOperator<V> updateFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции, возвращая обновленное значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    updateFunction - функция без побочных эффектов
    
    Возвраты:
    
    обновленное значение
    
    С тех пор:
    
    1.8
  - getAndAccumulate
```
public final V getAndAccumulate(T obj,
                                V x,
                                BinaryOperator<V> accumulatorFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая предыдущее значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков. Функция применяется с текущей стоимостью как ее первый параметр, и данное обновление как второй параметр.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    x - значение обновления
    
    accumulatorFunction - функция без побочных эффектов двух параметров
    
    Возвраты:
    
    предыдущее значение
    
    С тех пор:
    
    1.8
  - accumulateAndGet
```
public final V accumulateAndGet(T obj,
                                V x,
                                BinaryOperator<V> accumulatorFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая обновленное значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков. Функция применяется с текущей стоимостью как ее первый параметр, и данное обновление как второй параметр.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    x - значение обновления
    
    accumulatorFunction - функция без побочных эффектов двух параметров
    
    Возвраты:
    
    обновленное значение
    
    С тех пор:
    
    1.8

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс AtomicReferenceFieldUpdater <T, V>

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

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

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

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

AtomicReferenceFieldUpdater

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

newUpdater

compareAndSet

weakCompareAndSet

набор

lazySet

добраться

getAndSet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet