CKTIS / Java
AtomicIntegerFieldUpdater — aggiornamenti atomici di un campo int
AtomicIntegerFieldUpdater fornisce operazioni atomiche sul campo volatile int di un oggetto esistente. Un solo updater può servire più istanze di una classe, senza dover creare un oggetto AtomicInteger separato per ogni campo.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
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> del package java.util.concurrent.atomic opera su un campo volatile int selezionato di oggetti di tipo T. Il valore resta nell’oggetto e l’updater può essere condiviso tra le istanze. Questi strumenti consentono, tra le altre cose, aggiornamenti indipendenti dei campi nelle strutture dati concorrenti.
AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") associa un updater a un campo. L’argomento targetClass è un valore di tipo Class<T>. Il campo deve essere un volatile int non statico e accessibile al codice che crea l’updater secondo le regole di accesso di Java. Una dichiarazione, un nome o un accesso non validi causano un’eccezione durante la creazione.
get e compareAndSet sono metodi di istanza che si invocano sull’updater. updater.get(obj) legge il campo. updater.compareAndSet(obj, expect, update) scrive update solo se il valore corrente è == expect; restituisce true in caso di successo e false se il valore non corrisponde. Una lettura seguita da una scrittura separata non sostituisce questa operazione.
La garanzia di atomicità riguarda le chiamate a compareAndSet e set dello stesso updater, non modifiche arbitrarie al campo. Evita quindi di combinare meccanismi di aggiornamento indipendenti per uno stato condiviso. L’esempio a thread singolo mostra una modifica riuscita e una rifiutata; non è una verifica della correttezza in concorrenza.
Esempi
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));
}
}Risultato
0 true false 1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.