compact1, compact2, compact3

java.util.concurrent.atomic

Class DoubleAccumulator

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.DoubleAccumulator

All Implemented Interfaces:

Serializable

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因为情况预计将发生突变，而不是用作收集钥匙。

从以下版本开始：

一点八

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
DoubleAccumulator(DoubleBinaryOperator accumulatorFunction, double identity) 使用给定的“生成”函数和标识元素创建一个新实例。

方法摘要

Modifier and Type	Method and Description
void	accumulate(double x) 具有给定值的更新。
double	doubleValue() 相当于 get()。
float	floatValue() 作为一个窄化转换后 float返回 current value。
double	get() 返回当前值。
double	getThenReset() 相当的效果 get()随后 reset()。
int	intValue() 作为一个窄化转换后， int返回 current value。
long	longValue() 作为一个窄化转换后 long返回 current value。
void	reset() 重置变量保持更新的价值认同。
String	toString() 返回当前值的字符串表示形式。

Methods inherited from class java.lang.Number

byteValue, shortValue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

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()。

Specified by:

doubleValue 方法重写，继承类 Number

结果

目前的价值

longValue

public long longValue()

作为一个窄化转换后 long返回 current value。

Specified by:

longValue 方法重写，继承类 Number

结果

这代表的对象转换为数值型 long后。

intValue

public int intValue()

作为一个窄化转换后， int返回 current value。

Specified by:

intValue 方法重写，继承类 Number

结果

这代表的对象转换为数值型 int后。

floatValue

public float floatValue()

作为一个窄化转换后 float返回 current value。

Specified by:

floatValue 方法重写，继承类 Number

结果

这代表的对象转换为数值型 float后。