Класс 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, поскольку предполагается, что экземпляры будут изменяться, а значит, они не подходят в качестве ключей коллекций.