Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

VarHandle: čítanie acquire, zápis release a atómové CAS

V Java SE 21 môžeš získať prístupový objekt pre bežné pole `int`, zvoliť usporiadanie pamäťových operácií pri čítaní a zápise a podmienene zmeniť hodnotu jedinou atómovou operáciou.

Verzia: 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);

V balíku java.lang.invoke vracia MethodHandles.lookup() vyhľadávací objekt s prístupovými právami volajúcej triedy. MethodHandles.Lookup.findVarHandle prijíma triedu objektu, od ktorej sa začína vyhľadávanie, a názov a presný typ inštančného poľa (int.class, nie Integer.class). Môže ísť o podtriedu, ktorá pole dedí, ak k nemu má vyhľadávací objekt prístup. Objekt VarHandle nie je viazaný na konkrétnu inštanciu: tú odovzdáš ako prvý argument každej operácie. Pre statické pole použi findStaticVarHandle; jeho operácie neprijímajú inštanciu.

Prístup sa kontroluje pri vytvorení objektu VarHandle. Ak pole s uvedeným názvom a typom neexistuje, vyvolá sa NoSuchFieldException. Ak je prístup zamietnutý alebo findVarHandle nájde statické pole, vyvolá sa IllegalAccessException. Objekt VarHandle pre súkromné pole neposkytuj nedôveryhodnému kódu: mohol by ho použiť bez ďalšej kontroly prístupu k poľu.

setRelease(obj, value) zapisuje s usporiadaním release a (int) handle.getAcquire(obj) číta s usporiadaním acquire. Ak čítanie acquire pozoruje zápis release do toho istého poľa, pamäťové prístupy pred zápisom sú usporiadané pred prístupmi po čítaní. Čítanie nečaká na novšiu hodnotu. Usporiadanie určuje režim objektu VarHandle: bežné pole int nemusí byť volatile a priame čítanie nemá sémantiku acquire.

compareAndSet(obj, expected, update) atómovo porovná aktuálny int cez == a pri zhode zapíše novú hodnotu a vráti true. Pri nezhode vráti false bez zápisu. Čítanie a pri úspechu aj zápis majú sémantiku volatile. Prístupové metódy sú polymorfné podľa signatúry: napriek Object... v deklaráciách určujú deskriptor volania typy na mieste volania vrátane pretypovania výsledku cez (int). Nekompatibilný typ môže vyvolať WrongMethodTypeException, neúspešné pretypovanie referencie ClassCastException a nepodporovaný režim (napríklad zápis do poľa final) UnsupportedOperationException.

Príklady

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);
    }
}

Výsledok

observed=1
updated=true
staleUpdate=false
finalState=2

V jednom vlákne program zapíše `1`, prečíta `1`, cez CAS ju zmení na `2` a odmietne druhý pokus so zastaranou očakávanou hodnotou `1`. Výstup ukazuje volania, nie viditeľnosť medzi vláknami.

Súvisiace lekcie

  • Java · Lekcia 57 · Pokročilá · Verzia: 2

Zdroje