CKTIS / Java
VarHandle: prístup acquire-release a atómové CAS
VarHandle poskytuje typovaný prístup k premenným s voliteľným poradím pamäťových operácií. Spoznajte getAcquire, setRelease a compareAndSet a rozlišujte publikovanie údajov od atómovej aktualizácie.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
VarHandle h = MethodHandles.lookup().findVarHandle(Owner.class, "field", int.class);
int value = (int) h.getAcquire(owner);
h.setRelease(owner, newValue);
boolean changed = h.compareAndSet(owner, expectedValue, newValue);java.lang.invoke.VarHandle predstavuje prístup k premennej. Pri inštančnom poli je prvým argumentom objekt, ktorý pole obsahuje. Handle vrátený metódou findVarHandle predvolene umožňuje prispôsobenie pri volaní: kompatibilné typy na mieste volania možno konvertovať podľa pravidiel MethodHandle.asType. Typ na mieste volania sa musí presne zhodovať s typom režimu prístupu len pri presnom volaní (napríklad po použití withInvokeExactBehavior).
VarHandle.setRelease bráni presunu skorších čítaní a zápisov za zápis release. VarHandle.getAcquire bráni presunu neskorších čítaní a zápisov pred čítanie acquire. Keď acquire prečíta zodpovedajúci zápis release, sprístupní aj skoršie zápisy publikačného vlákna. Samotné použitie oboch metód nezaručuje prečítanie novej hodnoty.
VarHandle.compareAndSet atómovo porovná aktuálnu hodnotu s očakávanou a náhradnú hodnotu zapíše iba pri zhode. Pri typoch float a double porovnáva priamo nezmenené bitové reprezentácie hodnôt; pri ostatných typoch platia pravidlá operátora ==. Rozlišuje teda kladnú a zápornú nulu, hoci ich == pri porovnávaní hodnôt s pohyblivou rádovou čiarkou považuje za rovnaké. Vráti boolean; čítanie má sémantiku volatile, rovnako ako úspešný zápis. Samostatné volania getAcquire a setRelease netvoria atómovú aktualizáciu.
Nesprávne typy môžu spôsobiť WrongMethodTypeException a nepodporovaný režim spôsobí UnsupportedOperationException. Jednovláknový príklad ukazuje deterministické výsledky, nie správnosť súbežného publikovania.
Príklady
import java.lang.invoke.MethodHandles;
import java.lang.invoke.VarHandle;
public class Main {
private int state;
public static void main(String[] args) throws ReflectiveOperationException {
VarHandle stateHandle = MethodHandles.lookup()
.findVarHandle(Main.class, "state", int.class);
Main owner = new Main();
stateHandle.setRelease(owner, 1);
int observed = (int) stateHandle.getAcquire(owner);
boolean first = stateHandle.compareAndSet(owner, 1, 2);
boolean second = stateHandle.compareAndSet(owner, 1, 3);
System.out.println(observed);
System.out.println(first);
System.out.println(second);
System.out.println((int) stateHandle.getAcquire(owner));
}
}Výsledok
1 true false 2
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.