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来维护可扩展的频率映射（一种直方图或多集）。 例如，要向ConcurrentHashMap<String,LongAdder> freqs添加一个计数，如果尚未存在，则可以使用freqs.computeIfAbsent(k -> new LongAdder()).increment();

该类扩展Number ，但不定义诸如方法equals ， hashCode和compareTo ，因为实例预计将发生突变，所以不如收集钥匙有用。

从以下版本开始：

1.8

另请参见：

Serialized Form

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	Method and Description
void	add(long x) 添加给定值。
void	decrement() 相当于 add(-1) 。
double	doubleValue() 返回 sum()为 double一个宽元转换后。
float	floatValue() 返回 sum()为 float一个宽元转换后。
void	increment() 相当于 add(1) 。
int	intValue() 在 缩小原始 int后返回 sum()作为int。
long	longValue() 相当于 sum() 。
void	reset() 将保持总和的变量重置为零。
long	sum() 返回当前总和。
long	sumThenReset() 相当于 sum()后跟 reset() 。
String	toString() 返回 sum()的String表示 形式 。

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

构造方法详细信息

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

将保持总和的变量重置为零。 该方法可能是创建新加法器的有用替代方法，但仅在没有并发更新时才有效。 因为这个方法本质上是racy，所以只有当已知没有线程同时更新时才应该使用它。

sumThenReset

public long sumThenReset()

相当于sum()后跟reset() 。 该方法可以例如在多线程计算之间的静态点期间使用。 如果与此方法同时存在更新，则返回值不能保证是重置前发生的最终值。

结果

总和

toString

public String toString()

返回 sum()的String表示 形式 。

重写：

toString在类别 Object

结果

该字符串表示的 sum()

longValue

public long longValue()

相当于 sum() 。

Specified by:

longValue在 Number

结果

总和

intValue

public int intValue()

在 缩小原始 int后返回 sum()作为int。

Specified by:

intValue在类别 Number

结果

该对象在转换为 int之后表示的 int 。

floatValue

public float floatValue()

返回 sum()为 float一个宽元转换后。

Specified by:

floatValue在类别 Number

结果

该对象在转换为 float之后表示的 float 。

doubleValue

public double doubleValue()

返回 sum()为 double一个宽元转换后。

Specified by:

doubleValue在 Number

结果

该对象在转换为 double之后表示的 double 。