CKTIS / Java
AtomicIntegerFieldUpdater — atomske posodobitve polja int
AtomicIntegerFieldUpdater omogoča atomske operacije nad poljem volatile int obstoječega objekta. En updater lahko uporabljate za več primerkov razreda, ne da bi za vsako polje potrebovali ločen objekt AtomicInteger.
Različica: 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 deluje z izbranim poljem volatile int objektov tipa T. Vrednost ostane v objektu, updater pa si lahko deli več primerkov. Takšni pripomočki omogočajo med drugim neodvisne posodobitve polj v sočasnih podatkovnih strukturah.
AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") poveže updater s poljem. Argument targetClass je vrednost tipa Class<T>. Polje mora biti nestatično polje tipa volatile int in mora biti po pravilih dostopa v Javi dostopno kodi, ki ustvari updater. Neveljavna deklaracija, ime ali dostop med ustvarjanjem povzroči izjemo.
get in compareAndSet sta metodi primerka, ki ju kličemo na updaterju. updater.get(obj) prebere polje. updater.compareAndSet(obj, expect, update) zapiše update samo, če je trenutna vrednost == expect; ob uspehu vrne true, ob neujemanju pa false. Ločeno branje in nato zapis ne nadomestita te operacije.
Jamstvo atomskosti velja za klice compareAndSet in set istega updaterja, ne pa za poljubne druge spremembe polja. Zato za posodobitve deljenega stanja ne mešajte neodvisnih mehanizmov. Primer z eno nitjo pokaže uspešno in zavrnjeno spremembo; ni preizkus pravilnosti pri sočasnem izvajanju.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju točno te različice.