Класс LongAccumulator

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

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

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

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