compact1, compact2, compact3

java.util.concurrent.atomic

Class LongAccumulator

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.LongAccumulator

All Implemented Interfaces:

Serializable

public class LongAccumulator
extends Number
implements Serializable

一个或多个变量共同保持运行 long值更新，使用提供的功能。当更新（方法 accumulate(long)）主张跨线程、变量的设置可以动态增长以减少争用。方法 get()（或者，等价地， longValue()）返回当前值在变量保持更新。

这类通常是最好的AtomicLong当多个线程更新一个共同的价值，是用来为目的，如收集统计，不为细粒度的同步控制。在低更新争用下，两个类具有相似的特征。但在高争用，预计这一类的吞吐量显着更高，在更高的空间消耗的费用。

在或跨线程的积累的顺序是没有保证，不能依靠，所以这个类只适用于函数的积累，没有关系。所提供的蓄电池功能应该是免费的，因为它可能被重新应用时尝试更新失败，由于线程之间的争用。函数以当前值作为其第一个参数，并且给出的更新作为第二个参数。例如，保持最大值，你可以供应Long::max随着Long.MIN_VALUE身份。

类LongAdder提供维护计数和常见的特殊情况，这一类的功能类似物。电话new LongAdder()相当于new LongAccumulator((x, y) -> x + y, 0L。

这类Number延伸，但不定义方法如equals，hashCode和compareTo因为情况预计将发生突变，而不是用作收集钥匙。

从以下版本开始：

一点八

另请参见：

Serialized Form

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	Method and Description
void	accumulate(long x) 具有给定值的更新。
double	doubleValue() 为扩大基本转换后的 double返回 current value。
float	floatValue() 为扩大基本转换后的 float返回 current value。
long	get() 返回当前值。
long	getThenReset() 相当的效果 get()随后 reset()。
int	intValue() 作为一个窄化转换后， int返回 current value。
long	longValue() 相当于 get()。
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

LongAccumulator

public LongAccumulator(LongBinaryOperator accumulatorFunction,
                       long identity)

使用给定的“生成”函数和标识元素创建一个新实例。

参数

accumulatorFunction -两参数无副作用的功能

identity身份（初始值）为蓄能器的功能

方法详细信息

accumulate

public void accumulate(long x)

具有给定值的更新。

参数

x -价值

get

public long get()

返回当前值。返回的值不是一个原子快照；调用在并发更新的情况下返回一个准确的结果，但同时发生的更新，而正在计算的值可能不被纳入。

结果

目前的价值

reset

public void reset()

重置变量保持更新的价值认同。这种方法可以创建一个新的更新的一个有用的替代，但仅是有效的如果没有并发更新。因为这种方法本质上是活泼的，只能当它是已知的，没有线程同时更新。

getThenReset

public long getThenReset()

相当的效果 get()随后 reset()。此方法可以应用于多线程计算之间的静态点时的例子。如果有更新并发的这种方法，返回的值不保证是在复位之前发生的最终值。

结果

复位前的值

toString

public String toString()

返回当前值的字符串表示形式。

重写：

toString 方法重写，继承类 Object

结果

当前值的字符串表示形式

longValue

public long longValue()

相当于 get()。

Specified by:

longValue 方法重写，继承类 Number

结果

目前的价值

intValue

public int intValue()

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

Specified by:

intValue 方法重写，继承类 Number

结果

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

floatValue

public float floatValue()

为扩大基本转换后的 float返回 current value。

Specified by:

floatValue 方法重写，继承类 Number

结果

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

doubleValue

public double doubleValue()

为扩大基本转换后的 double返回 current value。

Specified by:

doubleValue 方法重写，继承类 Number

结果

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