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

Подробное описание конструкторов

DoubleAccumulator

public DoubleAccumulator(DoubleBinaryOperator accumulatorFunction,
                         double identity)

Создает новый экземпляр, используя заданную функцию накопления и элемент тождества.

Параметры:

accumulatorFunction - функция без побочных эффектов от двух аргументов

identity - идентичность (начальное значение) для функции накопления

Подробное описание методов

accumulate

public void accumulate(double x)

Обновляет с заданным значением.

Параметры:

x - значение

get

public double get()

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

Возвращает:

текущее значение

reset

public void reset()

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

getThenReset

public double getThenReset()

Эквивалентно get() после reset(). Этот метод может быть полезен, например, во время точек покоя между многопоточными вычислениями. Если есть обновления, происходящие одновременно с этим методом, возвращаемое значение не гарантирует быть последним значением, возникшим перед сбросом.

Возвращает:

значение до сброса

toString

public String toString()

Возвращает строковое представление текущего значения.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление текущего значения

doubleValue

public double doubleValue()

Эквивалентно get().

Определено в:

doubleValue в классе Number

Возвращает:

текущее значение

longValue

public long longValue()

Возвращает текущее значение как long после сужения преобразования примитивов.

Определено в:

longValue в классе Number

Возвращает:

численное значение, представленное этим объектом после преобразования в тип long.

intValue

public int intValue()

Возвращает текущее значение как int после сужения преобразования примитивов.

Определено в:

intValue в классе Number

Возвращает:

численное значение, представленное этим объектом после преобразования в тип int.

floatValue

public float floatValue()

Возвращает текущее значение как float после сужения преобразования примитивов.

Определено в:

floatValue в классе Number

Возвращает:

численное значение, представленное этим объектом после преобразования в тип float.