Класс LongAccumulator

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

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

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

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