CKTIS / Java
AtomicReference — atomowa aktualizacja referencji
AtomicReference<V> udostępnia atomowe operacje na jednej referencji. Poznaj odczyt get(), warunkową zamianę compareAndSet() i bezwarunkową zamianę getAndSet(), a także różnicę między tożsamością obiektów a równością ich treści.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
AtomicReference<V> ref = new AtomicReference<>(initialValue);
V current = ref.get();
boolean changed = ref.compareAndSet(expectedValue, newValue);
V previous = ref.getAndSet(newValue);AtomicReference<V> z pakietu java.util.concurrent.atomic przechowuje jedną referencję aktualizowaną atomowo. Chroni operacje na referencji, nie pola wskazywanego obiektu; nie czyni go automatycznie bezpiecznym wątkowo.
AtomicReference.get() odczytuje referencję z semantyką odczytu volatile. AtomicReference.compareAndSet(expectedValue, newValue) atomowo porównuje i zamienia: używa ==, nie equals(). Zwraca true po zamianie, a przy niedopasowaniu zwraca false bez zmiany wartości.
AtomicReference.getAndSet(newValue) bezwarunkowo, atomowo podmienia referencję i zwraca poprzednią. Osobne wywołania get() i zapisu nie tworzą jednej atomowej operacji; między nimi może zadziałać inny wątek.
Przykład działa w jednym wątku dla deterministycznego wyniku. Dwa obiekty new String("ready") mają równą treść, ale różną tożsamość: pierwsze porównanie zawodzi, drugie używa zapisanej referencji i się udaje. Zakres dokumentacji: Java SE 21; środowisko repozytorium i środowisko produkcyjne nie zostały potwierdzone.
Przykłady
import java.util.concurrent.atomic.AtomicReference;
public class Main {
public static void main(String[] args) {
String initial = new String("ready");
AtomicReference<String> ref = new AtomicReference<>(initial);
System.out.println(ref.get());
System.out.println(ref.compareAndSet(new String("ready"), "wrong"));
System.out.println(ref.compareAndSet(initial, "running"));
System.out.println(ref.getAndSet("done"));
System.out.println(ref.get());
}
}Wynik
ready false true running done
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.