模块 java.base
包 java.util.concurrent.atomic

类 AtomicReference<V>

java.lang.Object
java.util.concurrent.atomic.AtomicReference<V>
类型参数：
V - 此引用引用的对象类型
所有已实现的接口：
Serializable
public class AtomicReference<V> extends Object implements Serializable
可以自动更新的对象引用。有关原子访问属性的描述，请参阅 VarHandle 规范。
自从：
1.5
参见：

  • 构造方法详细信息

    • AtomicReference

      public AtomicReference(V  initialValue)
      使用给定的初始值创建一个新的 AtomicReference。
      参数：
      initialValue - 初始值

    • AtomicReference

      public AtomicReference()
      创建一个初始值为 null 的新 AtomicReference。

  • 方法详情

    • get

      public final V  get()
      返回当前值，具有 VarHandle.getVolatile(java.lang.Object...) 指定的记忆效应。
      返回：
      当前值

    • set

      public final void set(V  newValue)
      将值设置为 newValue ，具有 VarHandle.setVolatile(java.lang.Object...) 指定的记忆效应。
      参数：
      newValue - 新值

    • lazySet

      public final void lazySet(V  newValue)
      将值设置为 newValue ，具有 VarHandle.setRelease(java.lang.Object...) 指定的记忆效应。
      参数：
      newValue - 新值
      自从：
      1.6

    • compareAndSet

      public final boolean compareAndSet(V  expectedValue, V  newValue)
      如果当前值为 == expectedValue，则以原子方式将值设置为 newValue，并具有由 VarHandle.compareAndSet(java.lang.Object...) 指定的记忆效应。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      true 如果成功。错误返回表示实际值不等于预期值。

    • weakCompareAndSet

      @Deprecated (since ="9") public final boolean weakCompareAndSet(V  expectedValue, V  newValue)
      已弃用。
      此方法具有普通记忆效应，但方法名称暗示易失性记忆效应（请参阅 compareAndExchange(V, V) 和 compareAndSet(V, V) 等方法）。为避免混淆普通或易失性记忆效应，建议改用方法 weakCompareAndSetPlain(V, V) 。
      如果当前值为 == expectedValue，则可能自动将该值设置为 newValue，并具有由 VarHandle.weakCompareAndSetPlain(java.lang.Object...) 指定的记忆效应。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      true 如果成功
      参见：

    • weakCompareAndSetPlain

      public final boolean weakCompareAndSetPlain(V  expectedValue, V  newValue)
      如果当前值为 == expectedValue，则可能自动将该值设置为 newValue，并具有由 VarHandle.weakCompareAndSetPlain(java.lang.Object...) 指定的记忆效应。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      true 如果成功
      自从：
      9

    • getAndSet

      public final V  getAndSet(V  newValue)
      以原子方式将值设置为 newValue 并返回旧值，具有 VarHandle.getAndSet(java.lang.Object...) 指定的记忆效应。
      参数：
      newValue - 新值
      返回：
      以前的值

    • getAndUpdate

      public final V  getAndUpdate(UnaryOperator <V > updateFunction)
      以原子方式更新（具有 VarHandle.compareAndSet(java.lang.Object...) 指定的记忆效应）当前值与应用给定函数的结果，返回先前的值。该函数应该是无副作用的，因为当由于线程之间的争用而尝试更新失败时，它可能会被重新应用。
      参数：
      updateFunction - 无副作用的函数
      返回：
      以前的值
      自从：
      1.8

    • updateAndGet

      public final V  updateAndGet(UnaryOperator <V > updateFunction)
      使用给定函数的应用结果以原子方式更新（具有 VarHandle.compareAndSet(java.lang.Object...) 指定的记忆效应）当前值，返回更新后的值。该函数应该是无副作用的，因为当由于线程之间的争用而尝试更新失败时，它可能会被重新应用。
      参数：
      updateFunction - 无副作用的函数
      返回：
      更新值
      自从：
      1.8

    • getAndAccumulate

      public final V  getAndAccumulate(V  x, BinaryOperator <V > accumulatorFunction)
      以原子方式更新（具有 VarHandle.compareAndSet(java.lang.Object...) 指定的记忆效应）当前值以及将给定函数应用于当前值和给定值的结果，并返回先前的值。该函数应该是无副作用的，因为当由于线程之间的争用而尝试更新失败时，它可能会被重新应用。该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。
      参数：
      x - 更新值
      accumulatorFunction - 两个参数的无副作用函数
      返回：
      以前的值
      自从：
      1.8

    • accumulateAndGet

      public final V  accumulateAndGet(V  x, BinaryOperator <V > accumulatorFunction)
      以原子方式更新（具有 VarHandle.compareAndSet(java.lang.Object...) 指定的记忆效应）当前值以及将给定函数应用于当前值和给定值的结果，并返回更新后的值。该函数应该是无副作用的，因为当由于线程之间的争用而尝试更新失败时，它可能会被重新应用。该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。
      参数：
      x - 更新值
      accumulatorFunction - 两个参数的无副作用函数
      返回：
      更新值
      自从：
      1.8

    • toString

      public String  toString()
      返回当前值的字符串表示形式。
      重写：
      toString 在类 Object 中
      返回：
      当前值的 String 表示形式

    • getPlain

      public final V  getPlain()
      返回当前值，具有读取的内存语义，就好像变量被声明为 non-volatile 一样。
      返回：
      值
      自从：
      9

    • setPlain

      public final void setPlain(V  newValue)
      将值设置为 newValue ，设置的内存语义就好像变量被声明为 non-volatile 和 non-final 一样。
      参数：
      newValue - 新值
      自从：
      9

    • getOpaque

      public final V  getOpaque()
      返回当前值，具有 VarHandle.getOpaque(java.lang.Object...) 指定的记忆效应。
      返回：
      值
      自从：
      9

    • setOpaque

      public final void setOpaque(V  newValue)
      将值设置为 newValue ，具有 VarHandle.setOpaque(java.lang.Object...) 指定的记忆效应。
      参数：
      newValue - 新值
      自从：
      9

    • getAcquire

      public final V  getAcquire()
      返回当前值，具有 VarHandle.getAcquire(java.lang.Object...) 指定的记忆效应。
      返回：
      值
      自从：
      9

    • setRelease

      public final void setRelease(V  newValue)
      将值设置为 newValue ，具有 VarHandle.setRelease(java.lang.Object...) 指定的记忆效应。
      参数：
      newValue - 新值
      自从：
      9

    • compareAndExchange

      public final V  compareAndExchange(V  expectedValue, V  newValue)
      如果当前值称为 witness value、== expectedValue，具有 VarHandle.compareAndExchange(java.lang.Object...) 指定的记忆效应，则原子地将值设置为 newValue。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      见证值，如果成功，它将与预期值相同
      自从：
      9

    • compareAndExchangeAcquire

      public final V  compareAndExchangeAcquire(V  expectedValue, V  newValue)
      如果当前值称为 witness value、== expectedValue，具有 VarHandle.compareAndExchangeAcquire(java.lang.Object...) 指定的记忆效应，则原子地将值设置为 newValue。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      见证值，如果成功，它将与预期值相同
      自从：
      9

    • compareAndExchangeRelease

      public final V  compareAndExchangeRelease(V  expectedValue, V  newValue)
      如果当前值称为 witness value、== expectedValue，具有 VarHandle.compareAndExchangeRelease(java.lang.Object...) 指定的记忆效应，则原子地将值设置为 newValue。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      见证值，如果成功，它将与预期值相同
      自从：
      9

    • weakCompareAndSetVolatile

      public final boolean weakCompareAndSetVolatile(V  expectedValue, V  newValue)
      如果当前值为 == expectedValue，则可能自动将该值设置为 newValue，并具有由 VarHandle.weakCompareAndSet(java.lang.Object...) 指定的记忆效应。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      true 如果成功
      自从：
      9

    • weakCompareAndSetAcquire

      public final boolean weakCompareAndSetAcquire(V  expectedValue, V  newValue)
      如果当前值为 == expectedValue，则可能自动将该值设置为 newValue，具有由 VarHandle.weakCompareAndSetAcquire(java.lang.Object...) 指定的记忆效应。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      true 如果成功
      自从：
      9

    • weakCompareAndSetRelease

      public final boolean weakCompareAndSetRelease(V  expectedValue, V  newValue)
      如果当前值为 == expectedValue，则可能自动将该值设置为 newValue，并具有由 VarHandle.weakCompareAndSetRelease(java.lang.Object...) 指定的记忆效应。
      参数：
      expectedValue - 期望值
      newValue - 新值
      返回：
      true 如果成功
      自从：
      9