java.util.concurrent.atomic
클래스 AtomicReferenceFieldUpdater<T, V>

java.lang.Object 
  java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T, V>

형태 파라미터:

T - 갱신 가능한 필드를 보관 유지하는 객체의 형태

V - 필드의 형태

public abstract class AtomicReferenceFieldUpdater<T, V>
extends Object 

지정된 클래스의 지정된 volatile 참조 필드의 원자 갱신이 가능한, 리플렉션 베이스의 유틸리티입니다. 이 클래스는 동일 노드의 복수의 참조 필드가 독립해 원자 갱신의 대상이 되는 원자 데이터 구조에서의 사용을 염두에 두어 설계되고 있습니다. 예를 들어 트리 노드는 다음과 같이 선언됩니다.

class Node {
private volatile Node left, right;

private static final AtomicReferenceFieldUpdater<Node, Node> leftUpdater =
AtomicReferenceFieldUpdater.newUpdater(Node.class, Node.class, "left");
private static AtomicReferenceFieldUpdater<Node, Node> rightUpdater =
AtomicReferenceFieldUpdater.newUpdater(Node.class, Node.class, "right");

Node getLeft() { return left;  }
boolean compareAndSetLeft(Node expect, Node update) {
return leftUpdater.compareAndSet(this, expect, update);
}
// ... and so on
}

이 클래스내의 compareAndSet 메서드의 보증은 다른 원자 클래스내의 그것보다 약한 것에 유의해 주세요. 이 클래스는 필드의 사용 모든 것이 원자 액세스에 적절하고 있는 것을 보증할 수 없기 때문에 compareAndSet 및 set 외 호출에 관한 보고 원자성 및 휘발성 시멘틱스를 보증할 수 있습니다.

도입된 버전 :

1.5

생성자 개요

protected

AtomicReferenceFieldUpdater () 서브 클래스에 의해 사용된다, 아무것도 실시하지 않는 protected constructor　 　.

메서드 개요

abstract boolean	compareAndSet (T obj, V expect, V update) 「현재의 값 == 예상되는 값」인 경우, 이 Updater가 관리하는 지정된 객체의 필드값을 원자적으로 설정합니다.
abstract V	get (T obj) 지정된 객체가 보관 유지하는 필드내의 현재가를 취득합니다.
V	getAndSet (T obj, V newValue) 지정된 값으로 설정해, 이전의 값을 리턴합니다.
static <U, W> AtomicReferenceFieldUpdater <U, W>	newUpdater (Class <U> tclass, Class <W> vclass, String fieldName) 지정된 필드를 가지는 객체의 업 데이터를 작성합니다.
abstract void	set (T obj, V newValue) 이 업 데이터에 의해 관리되는 지정된 객체의 필드를 설정합니다.
abstract boolean	weakCompareAndSet (T obj, V expect, V update) 「현재의 값 == 예상되는 값」인 경우, 이 Updater가 관리하는 지정된 객체의 필드값을 원자적으로 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

AtomicReferenceFieldUpdater

protected AtomicReferenceFieldUpdater()

서브 클래스에 의해 사용된다, 아무것도 실시하지 않는 protected constructor　 　.

메서드의 상세

newUpdater

public static <U, W> AtomicReferenceFieldUpdater <U, W> newUpdater(Class <U> tclass,
                                                                Class <W> vclass,
                                                                String  fieldName)

지정된 필드를 가지는 객체의 업 데이터를 작성합니다. Class 인수는 리플렉트 형과 범용형의 일치를 체크하기 위해서 필요합니다.

파라미터:

tclass - 필드를 보관 유지하는 객체의 클래스

vclass - 필드의 클래스

fieldName - 갱신하는 필드의 이름

반환값:

업 데이터

예외:

IllegalArgumentException - 필드가 휘발성의 참조형이 아닌 경우

RuntimeException - 클래스에 필드가 포함되지 않는가 형태가 부정한 경우에 상자로 된 리플렉션 베이스의 예외가 Throw 된다

compareAndSet

public abstract boolean compareAndSet(T  obj,
                                      V  expect,
                                      V  update)

「현재의 값 == 예상되는 값」인 경우, 이 Updater가 관리하는 지정된 객체의 필드값을 원자적으로 설정합니다. 이 메서드는 compareAndSet 및 set에 대한 다른 호출로 원자성을 가지는 것이 보증되고 있습니다만, 필드내의 다른 변경에 관해서는 반드시 그렇다라고는 한정하지 않습니다.

파라미터:

obj - 조건부로 필드를 설정하는 객체

expect - 예상되는 값

update - 새로운 값

반환값:

성공했을 경우는 true

weakCompareAndSet

public abstract boolean weakCompareAndSet(T  obj,
                                          V  expect,
                                          V  update)

「현재의 값 == 예상되는 값」인 경우, 이 Updater가 관리하는 지정된 객체의 필드값을 원자적으로 설정합니다. 이 메서드는 compareAndSet 및 set에 대한 다른 호출로 원자성을 가지는 것이 보증되고 있습니다만, 필드내의 다른 변경에 관해서는 반드시 그렇다라고는 한정하지 않습니다. 이것은 외관상 실패하는 경우가 있습니다.

파라미터:

obj - 조건부로 필드를 설정하는 객체

expect - 예상되는 값

update - 새로운 값

반환값:

성공했을 경우는 true

set

public abstract void set(T  obj,
                         V  newValue)

이 업 데이터에 의해 관리되는 지정된 객체의 필드를 설정합니다. 이 조작은 후속의 compareAndSet 호출에 관해서는 휘발성 스토어로서 동작하는 것이 보증되고 있습니다.

파라미터:

obj - 필드를 설정하는 객체

newValue - 새로운 값

get

public abstract V  get(T  obj)

지정된 객체가 보관 유지하는 필드내의 현재가를 취득합니다.

파라미터:

obj - 필드를 얻는 객체

반환값:

현재의 값

getAndSet

public V  getAndSet(T  obj,
                   V  newValue)

지정된 값으로 설정해, 이전의 값을 리턴합니다.

파라미터:

obj - 필드를 취득 및 설정하는 객체

newValue - 새로운 값

반환값:

전의값