LongAccumulator (Java Platform SE 8 )

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 ，因为实例预计将发生突变，所以不如收集钥匙有用。

从以下版本开始：

1.8

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)` 使用给定的累加器函数和identity元素创建一个新的实例。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`accumulate(long x)` 具有给定值的更新。
`double`	`doubleValue()` 返回 current value为 `double`一个宽元转换后。
`float`	`floatValue()` 返回 current value为 `float`一个宽元转换后。
`long`	`get()` 返回当前值。
`long`	`getThenReset()` 相当于 `get()`其次是 `reset()` 。
`int`	`intValue()` 在缩小原始 `int`后返回 current value作为int。
`long`	`longValue()` 相当于 `get()` 。
`void`	`reset()` 重置维持更新到标识值的变量。
`String`	`toString()` 返回当前值的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

- 构造方法详细信息
  - LongAccumulator
```
public LongAccumulator(LongBinaryOperator accumulatorFunction,
                       long identity)
```
    使用给定的累加器函数和identity元素创建一个新的实例。
    
    参数
    
    accumulatorFunction - 两个参数的无效副作用
    
    identity - 累加器功能的标识（初始值）
- 方法详细信息
  - accumulate
```
public void accumulate(long x)
```
    具有给定值的更新。
    
    参数
    
    x - 值
  - get
```
public long get()
```
    返回当前值。返回的值不是原子快照; 在没有并发更新的情况下调用返回一个准确的结果，但是在计算该值时发生的并发更新可能未被并入。
    
    结果
    
    当前值
  - reset
```
public void reset()
```
    重置维持更新到标识值的变量。此方法可能是创建新更新程序的有用替代方法，但仅在没有并发更新时才有效。因为这个方法本质上是racy，所以只有当已知没有线程同时更新时才应该使用它。
  - getThenReset
```
public long getThenReset()
```
    相当于将get()其次是reset() 。该方法可以例如在多线程计算之间的静态点期间使用。如果与此方法同时存在更新，则返回值不能保证是重置前发生的最终值。
    
    结果
    
    复位前的值
  - toString
```
public String toString()
```
    返回当前值的String表示形式。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    当前值的String表示形式
  - longValue
```
public long longValue()
```
    相当于 get() 。
    
    Specified by:
    
    longValue在类别 Number
    
    结果
    
    当前值
  - intValue
```
public int intValue()
```
    在缩小原始 int后返回 current value作为int。
    
    Specified by:
    
    intValue在类别 Number
    
    结果
    
    该对象在转换为 int之后表示的 int 。
  - floatValue
```
public float floatValue()
```
    返回 current value为 float一个宽元转换后。
    
    Specified by:
    
    floatValue在类别 Number
    
    结果
    
    该对象在转换为 float之后表示的 float 。
  - doubleValue
```
public double doubleValue()
```
    返回 current value为 double一个宽元转换后。
    
    Specified by:
    
    doubleValue在类别 Number
    
    结果
    
    该对象在转换为 double之后表示的 double 。

Class LongAccumulator

构造方法摘要

方法摘要

Methods inherited from class java.lang.Number

Methods inherited from class java.lang.Object

构造方法详细信息

LongAccumulator

方法详细信息

accumulate

get

reset

getThenReset

toString

longValue

intValue

floatValue

doubleValue