CKTIS / Java
VarHandle: Acquire-Lesen, Release-Schreiben und atomares CAS
In Java SE 21 kannst du ein Handle für ein gewöhnliches `int`-Feld erstellen, die Speicherordnung beim Lesen und Schreiben wählen und den Wert atomar bedingt ändern.
Version: Java SE 21
Syntax
VarHandle handle = MethodHandles.lookup().findVarHandle(VarHandleDemo.class, "state", int.class);
int observed = (int) handle.getAcquire(demo);
handle.setRelease(demo, newValue);
boolean updated = handle.compareAndSet(demo, expectedValue, newValue);In java.lang.invoke liefert MethodHandles.lookup() ein Lookup mit den Zugriffsrechten der aufrufenden Klasse. MethodHandles.Lookup.findVarHandle erwartet die Empfängerklasse, bei der die Suche beginnt, sowie den Namen und den exakten Typ des Instanzfelds (int.class, nicht Integer.class). Die Empfängerklasse kann eine Unterklasse sein, die das Feld erbt, sofern das Lookup darauf zugreifen darf. Das Handle ist nicht an ein Objekt gebunden: Jede Operation erhält die Instanz als erstes Argument. Für ein statisches Feld verwendest du findStaticVarHandle; dessen Operationen benötigen keine Instanz.
Der Zugriff wird beim Erstellen des Handles geprüft. Gibt es kein Feld mit dem angegebenen Namen und Typ, folgt NoSuchFieldException. Ist der Zugriff nicht erlaubt oder findet findVarHandle ein statisches Feld, folgt IllegalAccessException. Gib ein Handle für ein privates Feld nicht an nicht vertrauenswürdigen Code weiter: Er kann es ohne erneute Prüfung des Feldzugriffs verwenden.
setRelease(obj, value) schreibt mit Release-Ordnung, (int) handle.getAcquire(obj) liest mit Acquire-Ordnung. Beobachtet der Acquire-Lesezugriff den Release-Schreibzugriff auf dasselbe Feld, sind Speicherzugriffe vor dem Schreiben vor den Zugriffen nach dem Lesen geordnet. Der Lesezugriff wartet nicht auf einen neueren Wert. Der Handle-Modus bestimmt die Ordnung: Das gewöhnliche int-Feld muss nicht volatile sein, und direktes Lesen hat keine Acquire-Semantik.
compareAndSet(obj, expected, update) vergleicht den aktuellen int atomar per == und schreibt bei Übereinstimmung den neuen Wert und liefert true. Ohne Übereinstimmung liefert es false, ohne zu schreiben. Der Lesezugriff und bei Erfolg der Schreibzugriff haben volatile-Semantik. Die Zugriffsmethoden sind signaturpolymorph: Trotz Object... in den Deklarationen bestimmen die Typen an der Aufrufstelle einschließlich des Ergebniscasts (int) den Aufrufdeskriptor. Ein inkompatibler Typ kann WrongMethodTypeException, ein fehlgeschlagener Referenzcast ClassCastException auslösen. Ein nicht unterstützter Modus (etwa Schreiben in ein final-Feld) löst UnsupportedOperationException aus.
Beispiele
import java.lang.invoke.MethodHandles;
import java.lang.invoke.VarHandle;
public class VarHandleDemo {
private int state;
public static void main(String[] args) throws ReflectiveOperationException {
VarHandle stateHandle = MethodHandles.lookup()
.findVarHandle(VarHandleDemo.class, "state", int.class);
VarHandleDemo demo = new VarHandleDemo();
stateHandle.setRelease(demo, 1);
int observed = (int) stateHandle.getAcquire(demo);
boolean updated = stateHandle.compareAndSet(demo, observed, 2);
boolean staleUpdate = stateHandle.compareAndSet(demo, 1, 3);
int finalState = (int) stateHandle.getAcquire(demo);
System.out.println("observed=" + observed);
System.out.println("updated=" + updated);
System.out.println("staleUpdate=" + staleUpdate);
System.out.println("finalState=" + finalState);
}
}Ergebnis
observed=1 updated=true staleUpdate=false finalState=2
Das Programm schreibt in einem Thread `1`, liest `1`, ändert den Wert per CAS auf `2` und weist den zweiten Versuch mit dem veralteten Erwartungswert `1` ab. Die Ausgabe zeigt die Aufrufe, nicht die Sichtbarkeit zwischen Threads.
Zugehörige Lektionen
- Java · Lektion 57 · Fortgeschritten · Version: 2