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包装规范。

从以下版本开始：

一点五

另请参见：

Serialized Form

构造方法摘要

构造方法

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

方法摘要

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给更新后的值，如果电流值 ==期望值。
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() 返回数组当前值的字符串表示形式。
E	updateAndGet(int i, UnaryOperator<E> updateFunction) 自动更新的元素在指数 i结果应用给定的函数，返回更新后的值。
boolean	weakCompareAndSet(int i, E expect, E update) 自动设置元素的位置 i给更新后的值，如果电流值 ==期望值。

Methods inherited from class java.lang.Object

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

Constructor Detail

AtomicReferenceArray

public AtomicReferenceArray(int length)

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

参数

length -数组的长度

AtomicReferenceArray

public AtomicReferenceArray(E[] array)

创建具有相同的长度作为一个新的AtomicReferenceArray，和所有的元素复制，给定的数组。

参数

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 -新价值

从以下版本开始：

一点六

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 -指数

expect -期望值

update -新价值

结果

true如果成功。错误返回表示实际值不等于期望值。

weakCompareAndSet

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

自动设置元素的位置 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 -无副作用的功能

结果

以前的值

从以下版本开始：

一点八

updateAndGet

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

自动更新的元素在指数 i结果应用给定的函数，返回更新后的值。函数应该是免费的，因为它可能会被重新应用时尝试更新失败，由于线程之间的争用。

参数

i -指数

updateFunction -无副作用的功能

结果

更新后的值

从以下版本开始：

一点八

getAndAccumulate

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

自动更新与应用给出的函数的电流与给定值的结果指标 i元素，返回前一个值。函数应该是免费的，因为它可能会被重新应用时尝试更新失败，由于线程之间的争用。应用函数与当前价值指标 i作为其第一个参数，并给出更新作为第二个参数。

参数

i -指数

x -更新价值

accumulatorFunction -两参数无副作用的功能

结果

以前的值

从以下版本开始：

一点八

accumulateAndGet

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

自动更新与应用给出的函数的电流与给定值的结果指标 i元素，返回更新后的值。函数应该是免费的，因为它可能会被重新应用时尝试更新失败，由于线程之间的争用。应用函数与当前价值指标 i作为其第一个参数，并给出更新作为第二个参数。

参数

i -指数

x -更新价值

accumulatorFunction -两参数无副作用的功能

结果

更新后的值

从以下版本开始：

一点八

toString

public String toString()

返回数组当前值的字符串表示形式。

重写：

toString 方法重写，继承类 Object

结果

数组当前值的字符串表示形式