Класс DoubleAccumulator

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

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

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

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