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