compact1, compact2, compact3

java.util.concurrent.atomic

Класс LongAdder

java.lang. Объект

java.lang. Число

java.util.concurrent.atomic. LongAdder

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

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

public class LongAdder
extends Number
implements Serializable

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

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

LongAdders может использоваться с a ConcurrentHashMap поддержать масштабируемую карту частоты (форма гистограммы или мультимножества). Например, чтобы добавить количество к a ConcurrentHashMap<String,LongAdder> freqs, инициализируя, если не уже существующий, можно использовать freqs.computeIfAbsent(k -> new LongAdder()).increment();

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

С тех пор:

1.8

См. Также:

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

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

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

Конструктор и Описание
LongAdder() Создает новый сумматор с начальной суммой нуля.

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

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

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

byteValue, shortValue

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

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

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

LongAdder

public LongAdder()

Создает новый сумматор с начальной суммой нуля.

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

добавить

public void add(long x)

Добавляет данное значение.

Параметры:

x - значение, чтобы добавить

инкремент

public void increment()

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

декремент

public void decrement()

Эквивалентный add(-1).

сумма

public long sum()

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

Возвраты:

сумма

сброс

public void reset()

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

sumThenReset

public long sumThenReset()

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

Возвраты:

сумма

toString

public String toString()

Возвращает Строковое представление sum().

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

toString в class Object

Возвраты:

Строковое представление sum()

longValue

public long longValue()

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

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

longValue в class Number

Возвраты:

сумма

intValue

public int intValue()

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

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

intValue в class Number

Возвраты:

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

floatValue

public float floatValue()

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

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

floatValue в class Number

Возвраты:

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

doubleValue

public double doubleValue()

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

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

doubleValue в class Number

Возвраты:

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