CKTIS / Java
AtomicIntegerFieldUpdater — atomaire updates van een int-veld
AtomicIntegerFieldUpdater biedt atomaire bewerkingen op het volatile int-veld van een bestaand object. Eén updater kan voor meerdere instanties van een klasse worden gebruikt, zonder voor elk veld een afzonderlijk AtomicInteger-object te maken.
Versie: 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> uit het package java.util.concurrent.atomic werkt met een geselecteerd volatile int-veld van objecten van het type T. De waarde blijft in het object staan en de updater kan tussen instanties worden gedeeld. Zulke hulpmiddelen ondersteunen onder meer onafhankelijke veldupdates in gelijktijdige datastructuren.
AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") koppelt een updater aan een veld. Het argument targetClass is een waarde van het type Class<T>. Het veld moet een niet-statisch volatile int-veld zijn en volgens de toegangsregels van Java toegankelijk zijn voor de code die de updater maakt. Een ongeldige declaratie, naam of toegang veroorzaakt een uitzondering bij het aanmaken.
get en compareAndSet zijn instantiemethoden die je op de updater aanroept. updater.get(obj) leest het veld. updater.compareAndSet(obj, expect, update) schrijft update alleen als de huidige waarde == expect is; de methode retourneert true bij succes en false als de waarde niet overeenkomt. Een aparte leesbewerking gevolgd door een schrijfbewerking vervangt deze operatie niet.
De atomiciteitsgarantie geldt voor aanroepen van compareAndSet en set van dezelfde updater, niet voor willekeurige andere wijzigingen aan het veld. Combineer daarom geen onafhankelijke updatemechanismen voor gedeelde toestand. Het voorbeeld met één thread laat een geslaagde en een afgewezen wijziging zien; het is geen test van correctheid bij gelijktijdigheid.
Voorbeelden
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));
}
}Resultaat
0 true false 1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.