CKTIS / Java
VarHandle: dostęp acquire-release i atomowe CAS
VarHandle zapewnia typowany dostęp do zmiennych z wyborem porządku pamięci. Poznaj getAcquire, setRelease i compareAndSet oraz różnicę między publikacją danych a atomową aktualizacją.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
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 reprezentuje dostęp do zmiennej. Dla pola instancji pierwszym argumentem jest obiekt zawierający pole. Uchwyt zwrócony przez findVarHandle domyślnie dopuszcza adaptację wywołania: zgodne typy w miejscu wywołania można konwertować zgodnie z regułami MethodHandle.asType. Dokładna zgodność typu w miejscu wywołania z typem danego trybu dostępu jest wymagana tylko przy wywołaniu w trybie dokładnym (np. po użyciu withInvokeExactBehavior).
VarHandle.setRelease nie pozwala przenieść wcześniejszych odczytów i zapisów za zapis release. VarHandle.getAcquire nie pozwala przenieść późniejszych odczytów i zapisów przed odczyt acquire. Gdy acquire odczytuje odpowiadający mu zapis release, udostępnia również wcześniejsze zapisy publikującego wątku. Samo użycie obu metod nie gwarantuje odczytania nowej wartości.
VarHandle.compareAndSet atomowo porównuje bieżącą wartość z oczekiwaną i zapisuje nową tylko przy zgodności. Dla typów float i double porównuje surowe reprezentacje bitowe wartości, a dla pozostałych typów stosuje reguły operatora ==. Rozróżnia więc dodatnie i ujemne zero, choć zmiennoprzecinkowe == uznaje je za równe. Zwraca wynik typu boolean; odczyt ma semantykę volatile, podobnie jak udany zapis. Oddzielne wywołania getAcquire i setRelease nie tworzą atomowej aktualizacji.
Nieprawidłowe typy mogą powodować WrongMethodTypeException, a nieobsługiwany tryb — UnsupportedOperationException. Przykład jednowątkowy pokazuje deterministyczne wyniki, nie dowodzi poprawności współbieżnej publikacji.
Przykłady
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));
}
}Wynik
1 true false 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.