CKTIS / Java
AtomicLong — un contatore long atomico
AtomicLong contiene un singolo valore long e offre aggiornamenti atomici condivisi tra thread. Il metodo incrementAndGet() aumenta il valore di uno e restituisce il risultato aggiornato.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
AtomicLong counter = new AtomicLong(0L);
long updated = counter.incrementAndGet();java.util.concurrent.atomic.AtomicLong è un oggetto mutabile che contiene un singolo valore di tipo long. È adatto a contatori condivisi e numeri di sequenza. Il costruttore new AtomicLong() imposta inizialmente il valore a zero; new AtomicLong(0L) specifica esplicitamente quel valore. Non sostituisce un oggetto Long immutabile.
AtomicLong.incrementAndGet() esegue la lettura, l’incremento di uno e la scrittura come un’unica operazione atomica, quindi restituisce il valore long aggiornato. Al contrario, getAndIncrement() restituisce il valore precedente all’incremento. get() legge il valore corrente.
L’atomicità di un singolo metodo non comprende una sequenza arbitraria di chiamate: counter.set(counter.get() + 1) non è un incremento atomico. Un altro thread può modificare il contatore tra la lettura e la scrittura. Per questo aggiornamento usa counter.incrementAndGet(); inoltre, il contatore da solo non protegge gli invarianti che coinvolgono più variabili.
Nell’esempio, due thread incrementano ciascuno 1000 volte lo stesso contatore. Entrambe le chiamate a join() precedono la lettura del risultato, quindi l’ordine di esecuzione dei thread non cambia l’output atteso 2000. Ambito della documentazione: Java SE 21; gli ambienti di runtime del repository e di produzione non sono attestati.
Esempi
import java.util.concurrent.atomic.AtomicLong;
public class Main {
public static void main(String[] args) throws InterruptedException {
AtomicLong counter = new AtomicLong(0L);
Runnable work = () -> {
for (int i = 0; i < 1000; i++) {
counter.incrementAndGet();
}
};
Thread first = new Thread(work);
Thread second = new Thread(work);
first.start();
second.start();
first.join();
second.join();
System.out.println(counter.get());
}
}Risultato
2000
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.