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.