CKTIS / Java
AtomicIntegerFieldUpdater — atomowa aktualizacja pola int
AtomicIntegerFieldUpdater udostępnia atomowe operacje na polu volatile int istniejącego obiektu. Jeden updater może obsługiwać wiele instancji klasy, bez osobnego obiektu AtomicInteger dla każdego pola.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
AtomicIntegerFieldUpdater<T> updater = AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName"); // targetClass is a Class<T>
int current = updater.get(obj);
boolean changed = updater.compareAndSet(obj, expect, update);AtomicIntegerFieldUpdater<T> z pakietu java.util.concurrent.atomic operuje na wybranym polu volatile int obiektów typu T. Wartość pozostaje w obiekcie, a updater można współdzielić między instancjami. Takie narzędzia służą między innymi do niezależnych aktualizacji pól w strukturach współbieżnych.
AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") wiąże updater z polem. Argument targetClass jest wartością typu Class<T>. Pole musi być niestatycznym volatile int i być dostępne dla kodu tworzącego updater zgodnie z regułami dostępu Javy. Nieprawidłowa deklaracja, nazwa lub dostęp powodują wyjątek podczas tworzenia.
get i compareAndSet to metody instancyjne wywoływane na updaterze. updater.get(obj) odczytuje wartość pola. updater.compareAndSet(obj, expect, update) zapisuje update tylko wtedy, gdy bieżąca wartość == expect; zwraca true przy sukcesie, a false przy niedopasowaniu. Oddzielne odczytanie i zapisanie wartości nie zastępuje tej operacji.
Gwarancja atomowości dotyczy wywołań compareAndSet i set tego samego updatera, nie dowolnych innych modyfikacji pola. Nie mieszaj więc niezależnych sposobów aktualizacji współdzielonego stanu. Przykład jednowątkowy pokazuje udaną i odrzuconą zmianę; nie jest testem poprawności współbieżnej.
Przykłady
import java.util.concurrent.atomic.AtomicIntegerFieldUpdater;
public class Main {
private volatile int state = 0;
private static final AtomicIntegerFieldUpdater<Main> STATE =
AtomicIntegerFieldUpdater.newUpdater(Main.class, "state");
public static void main(String[] args) {
Main item = new Main();
System.out.println(STATE.get(item));
System.out.println(STATE.compareAndSet(item, 0, 1));
System.out.println(STATE.compareAndSet(item, 0, 2));
System.out.println(STATE.get(item));
}
}Wynik
0 true false 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.