Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła