CKTIS / Java
AtomicIntegerFieldUpdater — atómové aktualizácie poľa int
AtomicIntegerFieldUpdater poskytuje atómové operácie nad poľom volatile int existujúceho objektu. Jeden updater možno použiť pre viacero inštancií triedy bez potreby vytvárať samostatný objekt AtomicInteger pre každé pole.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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íka java.util.concurrent.atomic pracuje s vybraným poľom volatile int objektov typu T. Hodnota zostáva v objekte a updater možno zdieľať medzi inštanciami. Tieto nástroje umožňujú okrem iného nezávislé aktualizácie polí v súbežných dátových štruktúrach.
AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") naviaže updater na pole. Argument targetClass je hodnota typu Class<T>. Pole musí byť nestatické volatile int a podľa pravidiel prístupu Javy prístupné kódu, ktorý updater vytvára. Neplatná deklarácia, názov alebo prístup spôsobí pri vytváraní výnimku.
get a compareAndSet sú inštančné metódy, ktoré sa volajú na updateri. updater.get(obj) prečíta pole. updater.compareAndSet(obj, expect, update) zapíše update iba vtedy, keď je aktuálna hodnota == expect; pri úspechu vráti true a pri nezhode false. Samostatné čítanie a následný zápis túto operáciu nenahrádzajú.
Záruka atomicity sa vzťahuje na volania compareAndSet a set toho istého updatera, nie na ľubovoľné iné zmeny poľa. Preto nemiešajte nezávislé mechanizmy aktualizácie zdieľaného stavu. Jednovláknový príklad ukazuje úspešnú a odmietnutú zmenu; nejde o test správnosti pri súbežnom vykonávaní.
Prí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ýsledok
0 true false 1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.