Класс LongAccumulator

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

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

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

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