Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

AtomicIntegerFieldUpdater — atomska ažuriranja polja int

AtomicIntegerFieldUpdater pruža atomske operacije nad poljem volatile int postojećeg objekta. Jedan updater može se koristiti za više instanci klase, bez zasebnog objekta AtomicInteger za svako polje.

Verzija: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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> iz paketa java.util.concurrent.atomic radi s odabranim poljem volatile int objekata tipa T. Vrijednost ostaje u objektu, a updater se može dijeliti između instanci. Takvi alati omogućuju, među ostalim, neovisna ažuriranja polja u konkurentnim strukturama podataka.

AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") povezuje updater s poljem. Argument targetClass vrijednost je tipa Class<T>. Polje mora biti nestatičko, deklarirano kao volatile int i, prema pravilima pristupa u Javi, dostupno kodu koji stvara updater. Neispravna deklaracija, naziv ili pristup uzrokuje iznimku tijekom stvaranja.

get i compareAndSet metode su instance koje se pozivaju na updateru. updater.get(obj) čita polje. updater.compareAndSet(obj, expect, update) zapisuje update samo ako je trenutačna vrijednost == expect; vraća true u slučaju uspjeha, a false ako se vrijednosti ne podudaraju. Zasebno čitanje pa zapisivanje ne zamjenjuje ovu operaciju.

Jamstvo atomarnosti obuhvaća pozive compareAndSet i set istog updatera, a ne proizvoljne druge izmjene polja. Zato nemojte miješati neovisne mehanizme ažuriranja dijeljenog stanja. Primjer s jednom dretvom prikazuje uspješnu i odbijenu promjenu; nije test ispravnosti u konkurentnom izvođenju.

Primjeri

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

Rezultat

0
true
false
1

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori