Класс DoubleAccumulator

public class DoubleAccumulator extends Number implements Serializable

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

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

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

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

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