Класс DoubleAccumulator

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

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

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

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