CKTIS / Java
AtomicIntegerFieldUpdater — atomare Aktualisierungen eines int-Felds
AtomicIntegerFieldUpdater stellt atomare Operationen für das volatile int-Feld eines vorhandenen Objekts bereit. Ein Updater kann für mehrere Instanzen einer Klasse verwendet werden, ohne für jedes Feld ein eigenes AtomicInteger-Objekt zu benötigen.
Version: 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> aus java.util.concurrent.atomic arbeitet mit einem ausgewählten volatile int-Feld von Objekten des Typs T. Der Wert bleibt im Objekt, und der Updater kann von mehreren Instanzen gemeinsam verwendet werden. Solche Hilfsmittel ermöglichen unter anderem unabhängige Feldaktualisierungen in nebenläufigen Datenstrukturen.
AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") bindet einen Updater an ein Feld. Das Argument targetClass ist ein Wert vom Typ Class<T>. Das Feld muss ein nicht-statisches volatile int sein und gemäß den Zugriffsregeln von Java für den Code zugänglich sein, der den Updater erstellt. Eine ungültige Deklaration, ein ungültiger Name oder fehlender Zugriff führt beim Erstellen zu einer Ausnahme.
get und compareAndSet sind Instanzmethoden, die auf dem Updater aufgerufen werden. updater.get(obj) liest das Feld. updater.compareAndSet(obj, expect, update) schreibt update nur, wenn der aktuelle Wert == expect ist; bei Erfolg wird true, bei einer Abweichung false zurückgegeben. Ein separates Lesen und anschließendes Schreiben ersetzt diesen Vorgang nicht.
Die Atomaritätsgarantie gilt für Aufrufe von compareAndSet und set desselben Updaters, nicht für beliebige andere Änderungen am Feld. Verwende daher nicht verschiedene, voneinander unabhängige Verfahren, um einen gemeinsam genutzten Zustand zu aktualisieren. Das Beispiel mit einem einzelnen Thread zeigt eine erfolgreiche und eine abgewiesene Änderung; es ist kein Test der Korrektheit bei Nebenläufigkeit.
Beispiele
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));
}
}Ergebnis
0 true false 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.