Module  java.base

Class AtomicLong

  • All Implemented Interfaces:
    Serializable


    public class AtomicLong
    extends Number
    implements Serializable
    A long可能原子更新的值。 有关原子访问属性的说明,请参阅VarHandle规范。 一个AtomicLong用于诸如原子增量序列号的应用中,不能用作Long的替代品。 但是,这个类确实扩展了Number以允许使用基于数字类的工具和实用程序的统一访问。
    从以下版本开始:
    1.5
    另请参见:
    Serialized Form
    • 构造方法详细信息

      • AtomicLong

        public AtomicLong​(long initialValue)
        用给定的初始值创建一个新的AtomicLong。
        参数
        initialValue - 初始值
      • AtomicLong

        public AtomicLong​()
        创建一个新的AtomicLong,初始值为 0
    • 方法详细信息

      • lazySet

        public final void lazySet​(long newValue)
        将值设置为 newValue ,具有 VarHandle.setRelease(java.lang.Object...)指定的内存效果。
        参数
        newValue - 新值
        从以下版本开始:
        1.6
      • getAndSet

        public final long getAndSet​(long newValue)
        将值设置为 newValue并返回旧值,具有 VarHandle.getAndSet(java.lang.Object...)指定的内存效果。
        参数
        newValue - 新值
        结果
        以前的值
      • compareAndSet

        public final boolean compareAndSet​(long expectedValue,
                                           long newValue)
        原子将值设置为 newValue如果当前值 == expectedValue如通过指定,记忆效应 VarHandle.compareAndSet(java.lang.Object...)
        参数
        expectedValue - 预期值
        newValue - 新值
        结果
        true如果成功。 False return表示实际值不等于预期值。
      • weakCompareAndSetPlain

        public final boolean weakCompareAndSetPlain​(long expectedValue,
                                                    long newValue)
        可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定,记忆效应 VarHandle.weakCompareAndSetPlain(java.lang.Object...)
        参数
        expectedValue - 期望值
        newValue - 新值
        结果
        true如果成功
        从以下版本开始:
        9
      • getAndAdd

        public final long getAndAdd​(long delta)
        原始地将给定值添加到当前值,具有由 VarHandle.getAndAdd(java.lang.Object...)指定的内存效果。
        参数
        delta - 要添加的值
        结果
        以前的值
      • decrementAndGet

        public final long decrementAndGet​()
        按照VarHandle.getAndAdd(java.lang.Object...)指定的内存效果,原子递减当前值。

        相当于addAndGet(-1)

        结果
        更新的值
      • addAndGet

        public final long addAndGet​(long delta)
        原始地将给定的值添加到当前值,具有由 VarHandle.getAndAdd(java.lang.Object...)指定的记忆效应。
        参数
        delta - 要添加的值
        结果
        更新的值
      • getAndUpdate

        public final long getAndUpdate​(LongUnaryOperator updateFunction)
        使用给定函数的结果对当前值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)指定的内存效果),返回上一个值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
        参数
        updateFunction - 无副作用的功能
        结果
        以前的值
        从以下版本开始:
        1.8
      • updateAndGet

        public final long updateAndGet​(LongUnaryOperator updateFunction)
        使用给定函数的结果对当前值进行原子更新(具有VarHandle.compareAndSet(java.lang.Object...)指定的内存效果),返回更新的值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
        参数
        updateFunction - 无副作用的功能
        结果
        更新的值
        从以下版本开始:
        1.8
      • getAndAccumulate

        public final long getAndAccumulate​(long x,
                                           LongBinaryOperator accumulatorFunction)
        将当前值与给定函数应用于当前值和给定值的原子更新(具有VarHandle.compareAndSet(java.lang.Object...)指定的存储器效果),返回上一个值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用当前值作为其第一个参数,给定的更新作为第二个参数。
        参数
        x - 更新值
        accumulatorFunction - 两个参数的无效副作用
        结果
        以前的值
        从以下版本开始:
        1.8
      • accumulateAndGet

        public final long accumulateAndGet​(long x,
                                           LongBinaryOperator accumulatorFunction)
        将当前值与给定函数应用于当前值和给定值的原子更新(具有VarHandle.compareAndSet(java.lang.Object...)指定的存储器效果),返回更新后的值。 该功能应该是无副作用的,因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用当前值作为其第一个参数,给定的更新作为第二个参数。
        参数
        x - 更新值
        accumulatorFunction - 两个参数的无效函数
        结果
        更新的值
        从以下版本开始:
        1.8
      • toString

        public String toString​()
        返回当前值的String表示形式。
        重写:
        toStringObject
        结果
        当前值的String表示形式
      • intValue

        public int intValue​()
        int之后返回 AtomicLong的当前值,作为 int ,在缩小的原始转换后,具有 VarHandle.getVolatile(java.lang.Object...)规定的记忆效应。
        Specified by:
        intValueNumber
        结果
        该对象在转换为 int之后表示的数值。
        See The Java™ Language Specification:
        5.1.3缩小原始转换
      • floatValue

        public float floatValue​()
        返回此的当前值 AtomicLong作为 float加宽原始转换后,通过规定的,具有记忆效果 VarHandle.getVolatile(java.lang.Object...)
        Specified by:
        floatValueNumber
        结果
        该对象在转换为 float之后表示的数值。
        See The Java™ Language Specification:
        5.1.2扩大原始转换
      • doubleValue

        public double doubleValue​()
        返回此的当前值 AtomicLong作为 double加宽原始转换后,通过规定的,具有记忆效果 VarHandle.getVolatile(java.lang.Object...)
        Specified by:
        doubleValueNumber
        结果
        该对象在转换为 double类型后表示的数值。
        See The Java™ Language Specification:
        5.1.2扩大原始转换
      • getPlain

        public final long getPlain​()
        返回当前值,具有读取的内存语义,就好像变量被声明为非 volatile
        结果
        价值
        从以下版本开始:
        9
      • setPlain

        public final void setPlain​(long newValue)
        将值设置为 newValue ,具有设置的内存语义,就像该变量被宣告为非 volatile final
        参数
        newValue - 新价值
        从以下版本开始:
        9
      • setOpaque

        public final void setOpaque​(long newValue)
        将值设置为 newValue ,具有 VarHandle.setOpaque(java.lang.Object...)指定的内存效果。
        参数
        newValue - 新值
        从以下版本开始:
        9
      • setRelease

        public final void setRelease​(long newValue)
        将值设置为 newValue ,具有 VarHandle.setRelease(java.lang.Object...)指定的内存效果。
        参数
        newValue - 新值
        从以下版本开始:
        9
      • compareAndExchange

        public final long compareAndExchange​(long expectedValue,
                                             long newValue)
        原子将值设置为 newValue如果当前值,被称为 证人值== expectedValue如通过指定,记忆效应 VarHandle.compareAndExchange(java.lang.Object...)
        参数
        expectedValue - 期望值
        newValue - 新的价值
        结果
        见证价值,如果成功,将与预期价值相同
        从以下版本开始:
        9
      • compareAndExchangeAcquire

        public final long compareAndExchangeAcquire​(long expectedValue,
                                                    long newValue)
        原子将值设置为 newValue如果当前值,被称为 证人值== expectedValue如通过指定,记忆效应 VarHandle.compareAndExchangeAcquire(java.lang.Object...)
        参数
        expectedValue - 预期值
        newValue - 新值
        结果
        见证价值,如果成功,将与预期价值相同
        从以下版本开始:
        9
      • compareAndExchangeRelease

        public final long compareAndExchangeRelease​(long expectedValue,
                                                    long newValue)
        原子将值设置为 newValue如果当前值,被称为 证人值== expectedValue如通过指定,记忆效应 VarHandle.compareAndExchangeRelease(java.lang.Object...)
        参数
        expectedValue - 期望值
        newValue - 新值
        结果
        见证价值,如果成功,将与预期价值相同
        从以下版本开始:
        9
      • weakCompareAndSetVolatile

        public final boolean weakCompareAndSetVolatile​(long expectedValue,
                                                       long newValue)
        可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定,记忆效应 VarHandle.weakCompareAndSet(java.lang.Object...)
        参数
        expectedValue - 预期值
        newValue - 新值
        结果
        true如果成功
        从以下版本开始:
        9
      • weakCompareAndSetAcquire

        public final boolean weakCompareAndSetAcquire​(long expectedValue,
                                                      long newValue)
        可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定,记忆效应 VarHandle.weakCompareAndSetAcquire(java.lang.Object...)
        参数
        expectedValue - 预期值
        newValue - 新值
        结果
        true如果成功
        从以下版本开始:
        9
      • weakCompareAndSetRelease

        public final boolean weakCompareAndSetRelease​(long expectedValue,
                                                      long newValue)
        可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定,记忆效应 VarHandle.weakCompareAndSetRelease(java.lang.Object...)
        参数
        expectedValue - 预期值
        newValue - 新值
        结果
        true如果成功
        从以下版本开始:
        9