java.util.concurrent.atomic
클래스 AtomicStampedReference<V>

java.lang.Object 
  java.util.concurrent.atomic.AtomicStampedReference<V>

형태 파라미터:

V - 이 참조에 의해 참조되는 객체의 형태

public class AtomicStampedReference<V>
extends Object 

AtomicStampedReference 은 원자적으로 갱신 가능한 정수 「스탬프」과 함께, 객체 참조를 관리합니다.

구현상의 주의. 이 구현은 괄호로 둘러싸인 [참조, 정수] 페어를 나타내는 내부 객체를 작성함으로써 스탬프 된 참조를 유지합니다.

도입된 버전 :

1.5

생성자 개요

AtomicStampedReference (V initialRef, int initialStamp)
지정된 초기값을 사용해, 새로운 AtomicStampedReference를 작성합니다.

메서드 개요

boolean	attemptStamp (V expectedReference, int newStamp) 「현재의 참조 == 예상되는 참조」인 경우는 스탬프의 값이 지정된 갱신치에 원자적으로 설정합니다.
boolean	compareAndSet (V expectedReference, V newReference, int expectedStamp, int newStamp) 「현재의 참조 == 예상되는 참조」이며, 현재의 스탬프가 예상되는 스탬프에 동일한 경우, 참조 및 스탬프의 값이 지정된 갱신치에 원자적으로 설정합니다.
V	get (int[] stampHolder) 참조 및 스탬프의 현재가를 리턴합니다.
V	getReference () 참조의 현재가를 리턴합니다.
int	getStamp () 스탬프의 현재가를 리턴합니다.
void	set (V newReference, int newStamp) 참조 및 스탬프의 값을 무조건 설정합니다.
boolean	weakCompareAndSet (V expectedReference, V newReference, int expectedStamp, int newStamp) 「현재의 참조 == 예상되는 참조」이며, 현재의 스탬프가 예상되는 스탬프에 동일한 경우, 참조와 스탬프의 양쪽 모두의 값이 지정된 갱신치에 원자적으로 설정합니다.

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

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

생성자 상세

AtomicStampedReference

public AtomicStampedReference(V  initialRef,
                              int initialStamp)

지정된 초기값을 사용해, 새로운 AtomicStampedReference를 작성합니다.

파라미터:

initialRef - 초기 참조

initialStamp - 초기 스탬프

메서드의 상세

getReference

public V  getReference()

참조의 현재가를 리턴합니다.

반환값:

참조의 현재가

getStamp

public int getStamp()

스탬프의 현재가를 리턴합니다.

반환값:

스탬프의 현재가

get

public V  get(int[] stampHolder)

참조 및 스탬프의 현재가를 리턴합니다. 보통 의 사용법은 int[1] holder; ref = v.get(holder); 입니다.

파라미터:

stampHolder - 1 이상의 사이즈의 배열. 돌려줄 때에 stampholder[0] 은 스탬프의 값을 보관 유지합니다.

반환값:

참조의 현재가

weakCompareAndSet

public boolean weakCompareAndSet(V  expectedReference,
                                 V  newReference,
                                 int expectedStamp,
                                 int newStamp)

「현재의 참조 == 예상되는 참조」이며, 현재의 스탬프가 예상되는 스탬프에 동일한 경우, 참조와 스탬프의 양쪽 모두의 값이 지정된 갱신치에 원자적으로 설정합니다. 이 조작의 지정된 호출이 외관상 실패하는 (false를 돌려준다)가 현재가가 예상되는 값을 보관 유지해, 그 값을 설정하려고 하는 다른 thread가 존재하지 않는 경우, 호출이 반복해지는 것으로 최종적으로 성공합니다.

파라미터:

expectedReference - 참조가 예상되는 값

newReference - 참조의 새로운 값

expectedStamp - 스탬프가 예상되는 값

newStamp - 스탬프의 새로운 값

반환값:

성공했을 경우는 true

compareAndSet

public boolean compareAndSet(V  expectedReference,
                             V  newReference,
                             int expectedStamp,
                             int newStamp)

「현재의 참조 == 예상되는 참조」이며, 현재의 스탬프가 예상되는 스탬프에 동일한 경우, 참조 및 스탬프의 값이 지정된 갱신치에 원자적으로 설정합니다.

파라미터:

expectedReference - 참조가 예상되는 값

newReference - 참조의 새로운 값

expectedStamp - 스탬프가 예상되는 값

newStamp - 스탬프의 새로운 값

반환값:

성공했을 경우는 true

set

public void set(V  newReference,
                int newStamp)

참조 및 스탬프의 값을 무조건 설정합니다.

파라미터:

newReference - 참조의 새로운 값

newStamp - 스탬프의 새로운 값

attemptStamp

public boolean attemptStamp(V  expectedReference,
                            int newStamp)

「현재의 참조 == 예상되는 참조」인 경우는 스탬프의 값이 지정된 갱신치에 원자적으로 설정합니다. 이 조작의 지정된 호출은 모두, 외관상 실패할 (false를 돌려줄) 가능성이 있습니다. 다만, 현재의 값이 예상되는 값을 보관 유지해, 값의 설정을 시도하는 다른 thread가 존재하지 않는 경우는 호출이 반복해지는 것으로 최종적으로 성공합니다.

파라미터:

expectedReference - 참조가 예상되는 값

newStamp - 스탬프의 새로운 값

반환값:

성공했을 경우는 true