Package com.oracle.coherence.concurrent.atomic

Class LocalAtomicLong

java.lang.Object
java.lang.Number
com.oracle.coherence.concurrent.atomic.LocalAtomicLong
All Implemented Interfaces:
AtomicLong, Serializable
public class LocalAtomicLong extends Number implements AtomicLong
Local implementation of AtomicLong interface, that simply wraps java.util.concurrent.atomic.AtomicLong instance.
Since:
21.12
Author:
Aleks Seovic 2020.12.03
See Also:

  • Nested Class Summary

    Nested classes/interfaces inherited from interface com.oracle.coherence.concurrent.atomic.AtomicLong

    AtomicLong.Serializer

  • Method Summary

    Modifier and Type
    Method
    Description
    long
    accumulateAndGet(long lUpdate, Remote.LongBinaryOperator accumulatorFunction)
    Atomically updates the current value with the results of applying the given function to the current and given values, returning the updated value.
    long
    accumulateAndGet(long lUpdate, LongBinaryOperator accumulatorFunction)
    Atomically updates the current value with the results of applying the given function to the current and given values, returning the updated value.
    long
    addAndGet(long lDelta)
    Atomically adds the given value to the current value.
    AsyncLocalAtomicLong
    async()
    Return non-blocking API for this atomic value.
    byte
    byteValue()
    Returns the current value of this AtomicLong as a byte after a narrowing primitive conversion.
    long
    compareAndExchange(long lExpectedValue, long lNewValue)
    Atomically sets the value to newValue if the current value, referred to as the witness value, == expectedValue.
    boolean
    compareAndSet(long lExpectedValue, long lNewValue)
    Atomically sets the value to newValue if the current value == expectedValue.
    long
    decrementAndGet()
    Atomically decrements the current value.
    double
    doubleValue()
    Returns the current value of this AtomicLong as a double after a widening primitive conversion.
    float
    floatValue()
    Returns the current value of this AtomicLong as a float after a widening primitive conversion.
    long
    get()
    Returns the current value.
    long
    getAndAccumulate(long lUpdate, Remote.LongBinaryOperator accumulatorFunction)
    Atomically updates the current value with the results of applying the given function to the current and given values, returning the previous value.
    long
    getAndAccumulate(long lUpdate, LongBinaryOperator accumulatorFunction)
    Atomically updates the current value with the results of applying the given function to the current and given values, returning the previous value.
    long
    getAndAdd(long lDelta)
    Atomically adds the given value to the current value.
    long
    getAndDecrement()
    Atomically decrements the current value.
    long
    getAndIncrement()
    Atomically increments the current value.
    long
    getAndSet(long lNewValue)
    Atomically sets the value to newValue and returns the old value.
    long
    getAndUpdate(Remote.LongUnaryOperator updateFunction)
    Atomically updates the current value with the results of applying the given function, returning the previous value.
    long
    getAndUpdate(LongUnaryOperator updateFunction)
    Atomically updates the current value with the results of applying the given function, returning the previous value.
    long
    incrementAndGet()
    Atomically increments the current value.
    int
    intValue()
    Returns the current value of this AtomicLong as an int after a narrowing primitive conversion.
    long
    longValue()
    Returns the current value of this AtomicLong as a long.
    void
    set(long lNewValue)
    Sets the value to newValue.
    short
    shortValue()
    Returns the current value of this AtomicLong as a short after a narrowing primitive conversion.
    String
    toString()
     
    long
    updateAndGet(Remote.LongUnaryOperator updateFunction)
    Atomically updates the current value with the results of applying the given function, returning the updated value.
    long
    updateAndGet(LongUnaryOperator updateFunction)
    Atomically updates the current value with the results of applying the given function, returning the updated value.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Method Details

    • async

      public AsyncLocalAtomicLong async()
      Description copied from interface: AtomicLong
      Return non-blocking API for this atomic value.
      Specified by:
      async in interface AtomicLong
      Returns:
      non-blocking API for this atomic value

    • get

      public long get()
      Description copied from interface: AtomicLong
      Returns the current value.
      Specified by:
      get in interface AtomicLong
      Returns:
      the current value

    • set

      public void set(long lNewValue)
      Description copied from interface: AtomicLong
      Sets the value to newValue.
      Specified by:
      set in interface AtomicLong
      Parameters:
      lNewValue - the new value

    • getAndSet

      public long getAndSet(long lNewValue)
      Description copied from interface: AtomicLong
      Atomically sets the value to newValue and returns the old value.
      Specified by:
      getAndSet in interface AtomicLong
      Parameters:
      lNewValue - the new value
      Returns:
      the previous value

    • compareAndSet

      public boolean compareAndSet(long lExpectedValue, long lNewValue)
      Description copied from interface: AtomicLong
      Atomically sets the value to newValue if the current value == expectedValue.
      Specified by:
      compareAndSet in interface AtomicLong
      Parameters:
      lExpectedValue - the expected value
      lNewValue - the new value
      Returns:
      true if successful. False return indicates that the actual value was not equal to the expected value.

    • getAndIncrement

      public long getAndIncrement()
      Description copied from interface: AtomicLong
      Atomically increments the current value.

      Equivalent to getAndAdd(1).

      Specified by:
      getAndIncrement in interface AtomicLong
      Returns:
      the previous value

    • getAndDecrement

      public long getAndDecrement()
      Description copied from interface: AtomicLong
      Atomically decrements the current value.

      Equivalent to getAndAdd(-1).

      Specified by:
      getAndDecrement in interface AtomicLong
      Returns:
      the previous value

    • getAndAdd

      public long getAndAdd(long lDelta)
      Description copied from interface: AtomicLong
      Atomically adds the given value to the current value.
      Specified by:
      getAndAdd in interface AtomicLong
      Parameters:
      lDelta - the value to add
      Returns:
      the previous value

    • incrementAndGet

      public long incrementAndGet()
      Description copied from interface: AtomicLong
      Atomically increments the current value.

      Equivalent to addAndGet(1).

      Specified by:
      incrementAndGet in interface AtomicLong
      Returns:
      the updated value

    • decrementAndGet

      public long decrementAndGet()
      Description copied from interface: AtomicLong
      Atomically decrements the current value.

      Equivalent to addAndGet(-1).

      Specified by:
      decrementAndGet in interface AtomicLong
      Returns:
      the updated value

    • addAndGet

      public long addAndGet(long lDelta)
      Description copied from interface: AtomicLong
      Atomically adds the given value to the current value.
      Specified by:
      addAndGet in interface AtomicLong
      Parameters:
      lDelta - the value to add
      Returns:
      the updated value

    • getAndUpdate

      public long getAndUpdate(Remote.LongUnaryOperator updateFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function, returning the previous value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads.
      Specified by:
      getAndUpdate in interface AtomicLong
      Parameters:
      updateFunction - a side-effect-free function
      Returns:
      the previous value

    • getAndUpdate

      public long getAndUpdate(LongUnaryOperator updateFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function, returning the previous value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads.
      Specified by:
      getAndUpdate in interface AtomicLong
      Parameters:
      updateFunction - a side-effect-free function
      Returns:
      the previous value

    • updateAndGet

      public long updateAndGet(Remote.LongUnaryOperator updateFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function, returning the updated value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads.
      Specified by:
      updateAndGet in interface AtomicLong
      Parameters:
      updateFunction - a side-effect-free function
      Returns:
      the updated value

    • updateAndGet

      public long updateAndGet(LongUnaryOperator updateFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function, returning the updated value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads.
      Specified by:
      updateAndGet in interface AtomicLong
      Parameters:
      updateFunction - a side-effect-free function
      Returns:
      the updated value

    • getAndAccumulate

      public long getAndAccumulate(long lUpdate, Remote.LongBinaryOperator accumulatorFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function to the current and given values, returning the previous value.

      The function should beside-effect-free, since it may be re-applied when attempted updates fail due to contention among threads. The function is applied with the current value as its first argument, and the given update as the second argument.

      Specified by:
      getAndAccumulate in interface AtomicLong
      Parameters:
      lUpdate - the update value
      accumulatorFunction - a side-effect-free function of two arguments
      Returns:
      the previous value

    • getAndAccumulate

      public long getAndAccumulate(long lUpdate, LongBinaryOperator accumulatorFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function to the current and given values, returning the previous value.

      The function should beside-effect-free, since it may be re-applied when attempted updates fail due to contention among threads. The function is applied with the current value as its first argument, and the given update as the second argument.

      Specified by:
      getAndAccumulate in interface AtomicLong
      Parameters:
      lUpdate - the update value
      accumulatorFunction - a side-effect-free function of two arguments
      Returns:
      the previous value

    • accumulateAndGet

      public long accumulateAndGet(long lUpdate, Remote.LongBinaryOperator accumulatorFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function to the current and given values, returning the updated value.

      The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads. The function is applied with the current value as its first argument, and the given update as the second argument.

      Specified by:
      accumulateAndGet in interface AtomicLong
      Parameters:
      lUpdate - the update value
      accumulatorFunction - a side-effect-free function of two arguments
      Returns:
      the updated value

    • accumulateAndGet

      public long accumulateAndGet(long lUpdate, LongBinaryOperator accumulatorFunction)
      Description copied from interface: AtomicLong
      Atomically updates the current value with the results of applying the given function to the current and given values, returning the updated value.

      The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads. The function is applied with the current value as its first argument, and the given update as the second argument.

      Specified by:
      accumulateAndGet in interface AtomicLong
      Parameters:
      lUpdate - the update value
      accumulatorFunction - a side-effect-free function of two arguments
      Returns:
      the updated value

    • compareAndExchange

      public long compareAndExchange(long lExpectedValue, long lNewValue)
      Description copied from interface: AtomicLong
      Atomically sets the value to newValue if the current value, referred to as the witness value, == expectedValue.
      Specified by:
      compareAndExchange in interface AtomicLong
      Parameters:
      lExpectedValue - the expected value
      lNewValue - the new value
      Returns:
      the witness value, which will be the same as the expected value if successful

    • intValue

      public int intValue()
      Description copied from interface: AtomicLong
      Returns the current value of this AtomicLong as an int after a narrowing primitive conversion.
      Specified by:
      intValue in interface AtomicLong
      Specified by:
      intValue in class Number
      Returns:
      the numeric value represented by this object after conversion to type int

    • longValue

      public long longValue()
      Description copied from interface: AtomicLong
      Returns the current value of this AtomicLong as a long.
      Specified by:
      longValue in interface AtomicLong
      Specified by:
      longValue in class Number
      Returns:
      the numeric value represented by this object

    • floatValue

      public float floatValue()
      Description copied from interface: AtomicLong
      Returns the current value of this AtomicLong as a float after a widening primitive conversion.
      Specified by:
      floatValue in interface AtomicLong
      Specified by:
      floatValue in class Number
      Returns:
      the numeric value represented by this object after conversion to type float

    • doubleValue

      public double doubleValue()
      Description copied from interface: AtomicLong
      Returns the current value of this AtomicLong as a double after a widening primitive conversion.
      Specified by:
      doubleValue in interface AtomicLong
      Specified by:
      doubleValue in class Number
      Returns:
      the numeric value represented by this object after conversion to type double

    • byteValue

      public byte byteValue()
      Description copied from interface: AtomicLong
      Returns the current value of this AtomicLong as a byte after a narrowing primitive conversion.
      Specified by:
      byteValue in interface AtomicLong
      Overrides:
      byteValue in class Number
      Returns:
      the numeric value represented by this object after conversion to type byte

    • shortValue

      public short shortValue()
      Description copied from interface: AtomicLong
      Returns the current value of this AtomicLong as a short after a narrowing primitive conversion.
      Specified by:
      shortValue in interface AtomicLong
      Overrides:
      shortValue in class Number
      Returns:
      the numeric value represented by this object after conversion to type short

    • toString

      public String toString()
      Overrides:
      toString in class Object