io.atlassian.util.concurrent.atomic

Class AtomicLongArray

java.lang.Object

java.util.concurrent.atomic.AtomicLongArray

io.atlassian.util.concurrent.atomic.AtomicLongArray

All Implemented Interfaces:

Serializable

public class AtomicLongArray
extends AtomicLongArray

AtomicReferenceArray with richer functionality. This class implements commonly implemented patterns of use of compareAndSet such as getOrSetAndGetIf(int, long, long) and update(int, Function) .

Since:

0.0.12

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AtomicLongArray(int length) Creates a new AtomicLongArray of given length.
AtomicLongArray(long[] initialValue) Creates a new AtomicLongArray with the same length as, and all elements copied from, the given array.

Method Summary

Modifier and Type	Method and Description
long	getOrSetAndGetIf(int index, long oldValue, long newValue) Check the current value and if it matches the old value argument, set it to the new value and return that instead.
long	update(int index, Function<Long,Long> newValueFactory) Do the actual update.

Methods inherited from class java.util.concurrent.atomic.AtomicLongArray

accumulateAndGet, addAndGet, compareAndSet, decrementAndGet, get, getAndAccumulate, getAndAdd, getAndDecrement, getAndIncrement, getAndSet, getAndUpdate, incrementAndGet, lazySet, length, set, toString, updateAndGet, weakCompareAndSet

Methods inherited from class java.lang.Object

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

Constructor Detail

AtomicLongArray

public AtomicLongArray(int length)

Creates a new AtomicLongArray of given length.

Parameters:

length - the length of the array

AtomicLongArray

public AtomicLongArray(long[] initialValue)

Creates a new AtomicLongArray with the same length as, and all elements copied from, the given array.

Parameters:

initialValue - the array to copy elements from

Throws:

NullPointerException - if array is null

Method Detail

getOrSetAndGetIf

public final long getOrSetAndGetIf(int index,
                                   long oldValue,
                                   long newValue)

Check the current value and if it matches the old value argument, set it to the new value and return that instead. If the old value argument does not match, ignore both and just return the current value.

Parameters:

index - the array index

oldValue - to check the current value against (reference equality check only)

newValue - the new value to set it to

Returns:

the current reference value if it doesn't match oldValue or a newly created value.

update

public final long update(int index,
                         Function<Long,Long> newValueFactory)

Do the actual update. Calls the factory method with the old value to do the update logic, then sets the value to that if it hasn't changed in the meantime.

Parameters:

index - a int.

newValueFactory - a Function object.

Returns:

the new updated value.