Module java.base
Package java.util.concurrent.atomic

Class DoubleAdder

java.lang.Object
java.lang.Number
java.util.concurrent.atomic.DoubleAdder
所有已实现的接口:
Serializable
public class DoubleAdder extends Number implements Serializable
一个或多个变量一起维护最初为零的double总和。当更新（方法add(double)）在线程之间存在争用时，变量集可能会动态增长以减少争用。方法sum()（或等效地doubleValue()）返回维护总和的变量之间的当前总和。在线程内或跨线程的累积顺序不能保证。因此，如果需要数值稳定性，特别是在合并数量级差异很大的值时，此类可能不适用。

当多个线程更新用于诸如频繁更新但较少读取的汇总统计等目的的共同值时，通常首选此类。

此类扩展了Number，但不定义诸如equals、hashCode和compareTo等方法，因为预计实例将被改变，因此不适用作集合键。

自从:
1.8
参见:

  • Constructor Details

    • DoubleAdder

      public DoubleAdder()
      创建一个初始总和为零的新加法器。

  • Method Details

    • add

      public void add(double x)
      添加给定的值。
      参数:
      x - 要添加的值

    • sum

      public double sum()
      返回当前总和。返回的值不是原子快照；在没有并发更新的情况下调用会返回准确的结果，但在计算总和时发生并发更新可能不会被合并。此外，由于浮点运算不是严格可结合的，返回的结果可能与在单个变量的顺序更新系列中获得的值不同。
      返回:
      总和

    • reset

      public void reset()
      将维护总和的变量重置为零。此方法可能是创建新加法器的有用替代方法，但仅在没有并发更新时有效。因为此方法本质上是竞争的，所以只有在已知没有线程同时更新时才应使用。

    • sumThenReset

      public double sumThenReset()
      等效于sum()后跟reset()。例如，在多线程计算之间的静态点期间，此方法可能适用。如果有与此方法并发的更新，返回的值不保证是重置之前发生的最终值。
      返回:
      总和

    • toString

      public String toString()
      返回sum()的字符串表示形式。
      覆盖:
      toString 在类 Object
      返回:
      sum()的字符串表示形式

    • doubleValue

      public double doubleValue()
      等效于sum()。
      指定者:
      doubleValue 在类 Number
      返回:
      总和

    • longValue

      public long longValue()
      返回一个缩小的原始转换后的long作为sum()。
      指定者:
      longValue 在类 Number
      返回:
      转换为long类型后此对象表示的数值。

    • intValue

      public int intValue()
      返回一个缩小的原始转换后的int作为sum()。
      指定者:
      intValue 在类 Number
      返回:
      转换为int类型后此对象表示的数值。

    • floatValue

      public float floatValue()
      返回一个缩小的原始转换后的float作为sum()。
      指定者:
      floatValue 在类 Number
      返回:
      转换为float类型后此对象表示的数值。