compact1, compact2, compact3

java.util.concurrent.atomic

Class AtomicReferenceArray<E>

java.lang.Object

java.util.concurrent.atomic.AtomicReferenceArray<E>

参数类型

E - 保存在此数组中的元素的基类

All Implemented Interfaces:

Serializable

public class AtomicReferenceArray<E>
extends Object
implements Serializable

可以以原子方式更新元素的对象引用数组。 有关原子变量属性的描述，请参阅java.util.concurrent.atomic包规范。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
AtomicReferenceArray(E[] array) 创建一个与原始数组相同的长度和所有元素的AtomicReferenceArray。
AtomicReferenceArray(int length) 创建给定长度的新AtomicReferenceArray，所有元素最初为null。

方法摘要

Modifier and Type	Method and Description
E	accumulateAndGet(int i, E x, BinaryOperator<E> accumulatorFunction) 以索引 i原子更新元素，并将给定函数应用于当前值和给定值，返回更新后的值。
boolean	compareAndSet(int i, E expect, E update) 如果当前值 ==为预期值，则 i地将位置 i处的元素设置为给定的更新值。
E	get(int i) 获取位置 i的当前值。
E	getAndAccumulate(int i, E x, BinaryOperator<E> accumulatorFunction) 以索引 i原子更新元素，并将给定的函数应用于当前值和给定值，返回上一个值。
E	getAndSet(int i, E newValue) 将位置 i的元素原子设置为给定值并返回旧值。
E	getAndUpdate(int i, UnaryOperator<E> updateFunction) 用索引 i原子更新元素，并使用给定函数的结果返回上一个值。
void	lazySet(int i, E newValue) 最终将位置 i的元素设置为给定值。
int	length() 返回数组的长度。
void	set(int i, E newValue) 将位置 i的元素设置为给定值。
String	toString() 返回数组的当前值的String表示形式。
E	updateAndGet(int i, UnaryOperator<E> updateFunction) 用索引 i原子更新应用给定函数的结果，返回更新后的值。
boolean	weakCompareAndSet(int i, E expect, E update) 如果当前值 ==为预期值，则 i地将位置 i处的元素设置为给定的更新值。

Methods inherited from class java.lang.Object

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

构造方法详细信息

AtomicReferenceArray

public AtomicReferenceArray(int length)

创建给定长度的新AtomicReferenceArray，所有元素最初为null。

参数

length - 数组的长度

AtomicReferenceArray

public AtomicReferenceArray(E[] array)

创建一个与原始数组相同的长度和所有元素的AtomicReferenceArray。

参数

array - array复制元素的数组

异常

NullPointerException - 如果数组为空

方法详细信息

length

public final int length()

返回数组的长度。

结果

数组的长度

get

public final E get(int i)

获取位置 i的当前值。

参数

i - 指数

结果

当前值

set

public final void set(int i,
                      E newValue)

将位置 i的元素设置为给定值。

参数

i - 索引

newValue - 新价值

lazySet

public final void lazySet(int i,
                          E newValue)

最终将位置 i的元素设置为给定值。

参数

i - 索引

newValue - 新的价值

从以下版本开始：

1.6

getAndSet

public final E getAndSet(int i,
                         E newValue)

将位置 i处的元素原子设置为给定值并返回旧值。

参数

i - 索引

newValue - 新价值

结果

以前的值

compareAndSet

public final boolean compareAndSet(int i,
                                   E expect,
                                   E update)

如果当前值 ==为期望值，则 i地将位置 i处的元素设置为给定的更新值。

参数

i - 指数

expect - 预期值

update - 新值

结果

true如果成功。 False return表示实际值不等于预期值。

weakCompareAndSet

public final boolean weakCompareAndSet(int i,
                                       E expect,
                                       E update)

如果当前值==为预期值，则i地将位置i处的元素设置为给定的更新值。

May fail spuriously and does not provide ordering guarantees ，所以只是很少适合替代compareAndSet 。

参数

i - 指数

expect - 期望值

update - 新值

结果

true如果成功

getAndUpdate

public final E getAndUpdate(int i,
                            UnaryOperator<E> updateFunction)

用索引i的元素原子更新应用给定函数的结果，返回上一个值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。

参数

i - 索引

updateFunction - 无副作用的功能

结果

以前的值

从以下版本开始：

1.8

updateAndGet

public final E updateAndGet(int i,
                            UnaryOperator<E> updateFunction)

使用应用给定函数的结果，原子更新索引i处的元素，返回更新的值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。

参数

i - 指数

updateFunction - 无副作用的功能

结果

更新的值

从以下版本开始：

1.8

getAndAccumulate

public final E getAndAccumulate(int i,
                                E x,
                                BinaryOperator<E> accumulatorFunction)

以索引i原子更新元素，并将给定的函数应用于当前值和给定值，返回上一个值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数以索引i作为其第一个参数的当前值应用，给定的更新作为第二个参数。

参数

i - 指数

x - 更新值

accumulatorFunction - 两个参数的无效副作用

结果

以前的值

从以下版本开始：

1.8

accumulateAndGet

public final E accumulateAndGet(int i,
                                E x,
                                BinaryOperator<E> accumulatorFunction)

以索引i原子更新元素，并将给定函数应用于当前值和给定值，返回更新后的值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用索引i作为其第一个参数的当前值，给定的更新作为第二个参数。

参数

i - 索引

x - 更新值

accumulatorFunction - 两个参数的无效副作用

结果

更新的值

从以下版本开始：

1.8

toString

public String toString()

返回数组的当前值的String表示形式。

重写：

toString在类别 Object

结果

数组的当前值的String表示形式