compact1, compact2, compact3

java.util.concurrent.atomic

Class LongAdder

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.LongAdder

All Implemented Interfaces:

Serializable

public class LongAdder
extends Number
implements Serializable

一个或多个变量一起保持最初的零 long总和。当更新（方法 add(long)）主张跨线程、变量的设置可以动态增长以减少争用。方法 sum()（或者，等价地， longValue()）返回当前的总变量之间保持的总和。

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

longadders可与ConcurrentHashMap保持可伸缩频率图（一种直方图或multiset）。例如，添加一个算一ConcurrentHashMap<String,LongAdder> freqs，初始化不存在的话，你可以使用freqs.computeIfAbsent(k -> new LongAdder()).increment();

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

从以下版本开始：

一点八

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
LongAdder() 创建一个新的加法器，初始和为零。

方法摘要

Modifier and Type	Method and Description
void	add(long x) 添加给定值。
void	decrement() 相当于 add(-1)。
double	doubleValue() 为扩大基本转换后的 double返回 sum()。
float	floatValue() 为扩大基本转换后的 float返回 sum()。
void	increment() 相当于 add(1)。
int	intValue() 作为一个窄化转换后， int返回 sum()。
long	longValue() 相当于 sum()。
void	reset() 重置变量保持总和为零。
long	sum() 返回当前的和。
long	sumThenReset() 相当的效果 sum()随后 reset()。
String	toString() 返回的字符串表示形式的 sum()。

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

LongAdder

public LongAdder()

创建一个新的加法器，初始和为零。

方法详细信息

add

public void add(long x)

添加给定值。

参数

x -价值增加

increment

public void increment()

相当于 add(1)。

decrement

public void decrement()

相当于 add(-1)。

sum

public long sum()

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

结果

的总和

reset

public void reset()

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

sumThenReset

public long sumThenReset()

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

结果

的总和

toString

public String toString()

返回的字符串表示形式的 sum()。

重写：

toString 方法重写，继承类 Object

结果

sum()的字符串表示形式

longValue

public long longValue()

相当于 sum()。

Specified by:

longValue 方法重写，继承类 Number

结果

的总和

intValue

public int intValue()

作为一个窄化转换后， int返回 sum()。

Specified by:

intValue 方法重写，继承类 Number

结果

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

floatValue

public float floatValue()

为扩大基本转换后的 float返回 sum()。

Specified by:

floatValue 方法重写，继承类 Number

结果

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

doubleValue

public double doubleValue()

为扩大基本转换后的 double返回 sum()。

Specified by:

doubleValue 方法重写，继承类 Number

结果

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