CKTIS / Java
LongAdder: incrementare, aggiungere e leggere il totale
Usa `increment()` per aggiungere uno, `add(long)` per applicare una variazione e `sum()` per leggere il totale. Scopri come combinare i totali parziali e quando la lettura dà un risultato esatto.
Versione: Java SE 21
Sintassi
Java SE 21 — java.util.concurrent.atomic.LongAdder
public LongAdder()
public void increment()
public void add(long x)
public long sum()
LongStream.collect: (left, right) -> left.add(right.sum())In Java SE 21, java.util.concurrent.atomic.LongAdder mantiene un totale di tipo long che più thread possono aggiornare. new LongAdder() parte da zero. increment() aggiunge uno, come add(1L). add(long x) aggiunge x, che può essere negativo. Entrambi i metodi restituiscono void. sum() restituisce un long senza azzerare il contatore.
In un LongStream.collect(...) parallelo, LongAdder::new crea nuovi contenitori per i risultati parziali. La funzione di accumulo elabora ogni elemento. La funzione di combinazione (left, right) -> left.add(right.sum()) legge il totale parziale di destra e lo aggiunge al contenitore di sinistra senza modificare quello di destra. Questa variante di collect mantiene separati i contenitori durante l’accumulo, quindi l’esecuzione in parallelo non richiede di per sé LongAdder.
Se ci sono aggiornamenti in corso, sum() non fornisce un’istantanea atomica: la lettura può non includere modifiche che avvengono nello stesso momento. Per ottenere un risultato finale esatto, leggi il contenitore restituito al termine di collect, come nell’esempio. Se gestisci tu i thread, usa Thread.join() per attendere la fine di tutti quelli che aggiornano il contatore e assicurati che nessun altro thread continui a modificarlo.
Esempi
import java.util.concurrent.atomic.LongAdder;
import java.util.stream.LongStream;
public class LongAdderDemo {
public static void main(String[] args) {
LongAdder total = LongStream.of(1, 4, 1, -2, 3)
.parallel()
.collect(LongAdder::new,
(partial, delta) -> {
if (delta == 1L) {
partial.increment();
} else {
partial.add(delta);
}
},
(left, right) -> left.add(right.sum()));
System.out.println(total.sum());
}
}Risultato
7
Il programma dovrebbe stampare `7`, perché `1 + 4 + 1 - 2 + 3 = 7`. Il risultato non dipende da come viene suddiviso lo stream e la lettura finale avviene dopo che `collect` ha restituito il risultato.
Lezioni correlate
- Java · Lezione 24 · Avanzato · Versione: 2