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

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

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

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

С тех пор:

1.5

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

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

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

Все Методы Статические Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`long`	`accumulateAndGet(T obj, long x, LongBinaryOperator accumulatorFunction)` Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая обновленное значение.
`long`	`addAndGet(T obj, long delta)` Атомарно добавляет данное значение к текущей стоимости поля данного объекта, которым управляет этот updater.
`abstract boolean`	`compareAndSet(T obj, long expect, long update)` Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость `==` математическое ожидание.
`long`	`decrementAndGet(T obj)` Атомарно декременты одним текущая стоимость поля данного объекта управляли этим updater.
`abstract long`	`get(T obj)` Содержали текущую стоимость в поле данного объекта, которым управляет этот updater.
`long`	`getAndAccumulate(T obj, long x, LongBinaryOperator accumulatorFunction)` Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая предыдущее значение.
`long`	`getAndAdd(T obj, long delta)` Атомарно добавляет данное значение к текущей стоимости поля данного объекта, которым управляет этот updater.
`long`	`getAndDecrement(T obj)` Атомарно декременты одним текущая стоимость поля данного объекта управляли этим updater.
`long`	`getAndIncrement(T obj)` Атомарно инкременты одним текущая стоимость поля данного объекта управляли этим updater.
`long`	`getAndSet(T obj, long newValue)` Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному значению, и возвращает старое значение.
`long`	`getAndUpdate(T obj, LongUnaryOperator updateFunction)` Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции, возвращая предыдущее значение.
`long`	`incrementAndGet(T obj)` Атомарно инкременты одним текущая стоимость поля данного объекта управляли этим updater.
`abstract void`	`lazySet(T obj, long newValue)` В конечном счете устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению.
`static <U> AtomicLongFieldUpdater<U>`	`newUpdater(Class<U> tclass, String fieldName)` Создает и возвращает updater для объектов с данным полем.
`abstract void`	`set(T obj, long newValue)` Устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению.
`long`	`updateAndGet(T obj, LongUnaryOperator updateFunction)` Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции, возвращая обновленное значение.
`abstract boolean`	`weakCompareAndSet(T obj, long expect, long update)` Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость `==` математическое ожидание.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - AtomicLongFieldUpdater
```
protected AtomicLongFieldUpdater()
```
    Защищенный пустой конструктор для использования подклассами.
- Деталь метода
  - newUpdater
```
public static <U> AtomicLongFieldUpdater<U> newUpdater(Class<U> tclass,
                                                       String fieldName)
```
    Создает и возвращает updater для объектов с данным полем. Параметр Класса необходим, чтобы проверить, что отражающие типы и универсальные типы соответствуют.
    
    Параметры:
    
    tclass - class удерживающих позиции объектов
    
    fieldName - имя поля, которое будет обновлено.
    
    Возвраты:
    
    updater
    
    Броски:
    
    IllegalArgumentException - если поле не является энергозависимым длинным типом.
    
    RuntimeException - с вложенным основанным на отражении исключением, если class не содержит поле или является неправильным типом, или поле недоступно вызывающей стороне согласно управлению доступом языка Java
  - compareAndSet
```
public abstract boolean compareAndSet(T obj,
                                      long expect,
                                      long update)
```
    Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость == математическое ожидание. Этот метод, как гарантируют, будет атомарным относительно других звонков compareAndSet и set, но не обязательно относительно других изменений в поле.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы условно установить
    
    expect - математическое ожидание
    
    update - новое значение
    
    Возвраты:
    
    истина в случае успеха
    
    Броски:
    
    ClassCastException - если obj не экземпляр class, обладающего полем, установленным в конструкторе.
  - weakCompareAndSet
```
public abstract boolean weakCompareAndSet(T obj,
                                          long expect,
                                          long update)
```
    Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению если текущая стоимость == математическое ожидание. Этот метод, как гарантируют, будет атомарным относительно других звонков compareAndSet и set, но не обязательно относительно других изменений в поле.
    Может перестать работать побочно и не обеспечивает гарантии упорядочивания, так только редко соответствующая альтернатива compareAndSet.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы условно установить
    
    expect - математическое ожидание
    
    update - новое значение
    
    Возвраты:
    
    истина в случае успеха
    
    Броски:
    
    ClassCastException - если obj не экземпляр class, обладающего полем, установленным в конструкторе.
  - набор
```
public abstract void set(T obj,
                         long newValue)
```
    Устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению. Эта работа, как гарантируют, будет действовать как энергозависимое хранилище относительно последующих вызовов compareAndSet.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы установить
    
    newValue - новое значение
  - lazySet
```
public abstract void lazySet(T obj,
                             long newValue)
```
    В конечном счете устанавливает поле данного объекта, которым управляет этот updater к данному обновленному значению.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы установить
    
    newValue - новое значение
    
    С тех пор:
    
    1.6
  - добраться
```
public abstract long get(T obj)
```
    Содержали текущую стоимость в поле данного объекта, которым управляет этот updater.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться
    
    Возвраты:
    
    текущая стоимость
  - getAndSet
```
public long getAndSet(T obj,
                      long newValue)
```
    Атомарно устанавливает поле данного объекта, которым управляет этот updater к данному значению, и возвращает старое значение.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    newValue - новое значение
    
    Возвраты:
    
    предыдущее значение
  - getAndIncrement
```
public long getAndIncrement(T obj)
```
    Атомарно инкременты одним текущая стоимость поля данного объекта управляли этим updater.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    Возвраты:
    
    предыдущее значение
  - getAndDecrement
```
public long getAndDecrement(T obj)
```
    Атомарно декременты одним текущая стоимость поля данного объекта управляли этим updater.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    Возвраты:
    
    предыдущее значение
  - getAndAdd
```
public long getAndAdd(T obj,
                      long delta)
```
    Атомарно добавляет данное значение к текущей стоимости поля данного объекта, которым управляет этот updater.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    delta - значение, чтобы добавить
    
    Возвраты:
    
    предыдущее значение
  - incrementAndGet
```
public long incrementAndGet(T obj)
```
    Атомарно инкременты одним текущая стоимость поля данного объекта управляли этим updater.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    Возвраты:
    
    обновленное значение
  - decrementAndGet
```
public long decrementAndGet(T obj)
```
    Атомарно декременты одним текущая стоимость поля данного объекта управляли этим updater.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    Возвраты:
    
    обновленное значение
  - addAndGet
```
public long addAndGet(T obj,
                      long delta)
```
    Атомарно добавляет данное значение к текущей стоимости поля данного объекта, которым управляет этот updater.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    delta - значение, чтобы добавить
    
    Возвраты:
    
    обновленное значение
  - getAndUpdate
```
public final long getAndUpdate(T obj,
                               LongUnaryOperator updateFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции, возвращая предыдущее значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    updateFunction - функция без побочных эффектов
    
    Возвраты:
    
    предыдущее значение
    
    С тех пор:
    
    1.8
  - updateAndGet
```
public final long updateAndGet(T obj,
                               LongUnaryOperator updateFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции, возвращая обновленное значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    updateFunction - функция без побочных эффектов
    
    Возвраты:
    
    обновленное значение
    
    С тех пор:
    
    1.8
  - getAndAccumulate
```
public final long getAndAccumulate(T obj,
                                   long x,
                                   LongBinaryOperator accumulatorFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая предыдущее значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков. Функция применяется с текущей стоимостью как ее первый параметр, и данное обновление как второй параметр.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    x - значение обновления
    
    accumulatorFunction - функция без побочных эффектов двух параметров
    
    Возвраты:
    
    предыдущее значение
    
    С тех пор:
    
    1.8
  - accumulateAndGet
```
public final long accumulateAndGet(T obj,
                                   long x,
                                   LongBinaryOperator accumulatorFunction)
```
    Атомарно обновляет поле данного объекта, которым управляет этот updater с результатами применения заданной функции к току и данным значениям, возвращая обновленное значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков. Функция применяется с текущей стоимостью как ее первый параметр, и данное обновление как второй параметр.
    
    Параметры:
    
    obj - Объект, чье поле, чтобы добраться и установить
    
    x - значение обновления
    
    accumulatorFunction - функция без побочных эффектов двух параметров
    
    Возвраты:
    
    обновленное значение
    
    С тех пор:
    
    1.8

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

Класс AtomicLongFieldUpdater <T>

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

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

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

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

AtomicLongFieldUpdater

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

newUpdater

compareAndSet

weakCompareAndSet

набор

lazySet

добраться

getAndSet

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet