compact1, compact2, compact3

java.util.concurrent.atomic

Класс LongAccumulator

java.lang. Объект

java.lang. Число

java.util.concurrent.atomic.LongAccumulator

Все Реализованные Интерфейсы:

Сериализуемый

public class LongAccumulator
extends Number
implements Serializable

Одна или более переменных, которые вместе поддерживают выполнение long оцените обновленное использование предоставленной функции. Когда обновления (метод accumulate(long)) спорятся через потоки, набор переменных может вырасти динамически, чтобы уменьшить конкуренцию. Метод get() (или, эквивалентно, longValue()) возвращает текущую стоимость через переменные, поддерживающие обновления.

Этот class обычно предпочтителен для AtomicLong когда многократные потоки обновляют общую ценность, которая используется в целях, таких как собирание статистических данных, не для мелкомодульного управления синхронизацией. В соответствии с низкой конкуренцией обновления, у этих двух классов есть подобные характеристики. Но в соответствии с высокой конкуренцией, ожидаемая пропускная способность этого class значительно выше, за счет более высокого потребления пространства.

Порядок накопления в пределах или через потоки не гарантируется и не может зависеться от, таким образом, этот class будет только применим к функциям, для которых не имеет значения порядок накопления. Предоставленная функция аккумулятора должна быть без побочных эффектов, так как она может быть повторно применена, когда предпринятые обновления перестали работать из-за конкуренции среди потоков. Функция применяется с текущей стоимостью как ее первый параметр, и данное обновление как второй параметр. Например, чтобы поддержать рабочее максимальное значение, Вы могли предоставить Long::max наряду с Long.MIN_VALUE как идентификационные данные.

Класс LongAdder обеспечивает аналоги функциональности этого class для общего особого случая поддержания количеств и сумм. Вызов new LongAdder() эквивалентно new LongAccumulator((x, y) -> x + y, 0L.

Этот class расширяется Number, но не определяет методы такой как equals, hashCode и compareTo потому что экземпляры, как ожидают, будут видоизменены, и так не полезны как ключи набора.

С тех пор:

1.8

См. Также:

Сериализированная Форма

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

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

Конструктор и Описание
LongAccumulator(LongBinaryOperator accumulatorFunction, long identity) Создает новый экземпляр, используя данную функцию аккумулятора и нейтральный элемент.

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

Модификатор и Тип	Метод и Описание
void	accumulate(long x) Обновления с данным значением.
double	doubleValue() Возвращает текущую стоимость как a double после расширяющегося примитивного преобразования.
float	floatValue() Возвращает текущую стоимость как a float после расширяющегося примитивного преобразования.
long	get() Возвращает текущую стоимость.
long	getThenReset() Эквивалентный в действительности get() сопровождаемый reset().
int	intValue() Возвращает текущую стоимость как int после сужающегося примитивного преобразования.
long	longValue() Эквивалентный get().
void	reset() Переменные сбросов, поддерживающие обновления к значению идентификационных данных.
Строка	toString() Возвращает Строковое представление текущей стоимости.

Методы, наследованные от class java.lang. Число

byteValue, shortValue

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

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

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

LongAccumulator

public LongAccumulator(LongBinaryOperator accumulatorFunction,
                       long identity)

Создает новый экземпляр, используя данную функцию аккумулятора и нейтральный элемент.

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

накопиться

public void accumulate(long x)

Обновления с данным значением.

Параметры:

x - значение

добраться

public long get()

Возвращает текущую стоимость. Возвращенное значение НЕ является атомарным снимком; вызов в отсутствие параллельных обновлений возвращает точный результат, но параллельные обновления, которые происходят, в то время как значение вычисляется, не могли бы быть включены.

Возвраты:

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

сброс

public void reset()

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

getThenReset

public long getThenReset()

Эквивалентный в действительности get() сопровождаемый reset(). Этот метод может применяться например во время статических точек между многопоточными вычислениями. Если будут обновления, параллельные с этим методом, то возвращенное значение, как гарантируют, не будет заключительным значением, происходящим перед сбросом.

Возвраты:

значение прежде, чем сброшено

toString

public String toString()

Возвращает Строковое представление текущей стоимости.

Переопределения:

toString в class Object

Возвраты:

Строковое представление текущей стоимости

longValue

public long longValue()

Эквивалентный get().

Определенный:

longValue в class Number

Возвраты:

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

intValue

public int intValue()

Возвращает текущую стоимость как int после сужающегося примитивного преобразования.

Определенный:

intValue в class Number

Возвраты:

числовое значение, представленное этим объектом после преобразования в тип int.

floatValue

public float floatValue()

Возвращает текущую стоимость как a float после расширяющегося примитивного преобразования.

Определенный:

floatValue в class Number

Возвраты:

числовое значение, представленное этим объектом после преобразования в тип float.

doubleValue

public double doubleValue()

Возвращает текущую стоимость как a double после расширяющегося примитивного преобразования.

Определенный:

doubleValue в class Number

Возвраты:

числовое значение, представленное этим объектом после преобразования в тип double.