Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

AtomicIntegerFieldUpdater — atomické aktualizace pole int

AtomicIntegerFieldUpdater poskytuje atomické operace nad polem volatile int existujícího objektu. Jeden updater lze použít pro více instancí třídy, aniž by bylo nutné vytvářet samostatný objekt AtomicInteger pro každé pole.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

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 balíčku java.util.concurrent.atomic pracuje s vybraným polem volatile int objektů typu T. Hodnota zůstává v objektu a updater lze sdílet mezi instancemi. Tyto nástroje umožňují mimo jiné nezávislé aktualizace polí v souběžných datových strukturách.

AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") naváže updater na pole. Argument targetClass je hodnota typu Class<T>. Pole musí být nestatické volatile int a podle pravidel přístupu Javy přístupné kódu, který updater vytváří. Neplatná deklarace, název nebo přístup způsobí při vytváření výjimku.

get a compareAndSet jsou instanční metody, které se volají na updateru. updater.get(obj) přečte pole. updater.compareAndSet(obj, expect, update) zapíše update pouze tehdy, když je aktuální hodnota == expect; při úspěchu vrátí true a při neshodě false. Samostatné přečtení a následný zápis tuto operaci nenahrazují.

Záruka atomicity se vztahuje na volání compareAndSet a set téhož updateru, nikoli na libovolné jiné změny pole. Nemíchejte proto nezávislé mechanismy aktualizace sdíleného stavu. Jednovláknový příklad ukazuje úspěšnou a odmítnutou změnu; nejde o test správnosti při souběžném běhu.

Příklady

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));
    }
}

Výsledek

0
true
false
1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje