CKTIS / Java
LongAdder : incrémenter, ajouter et lire la somme
Utilisez `increment()` pour ajouter un, `add(long)` pour appliquer une variation et `sum()` pour lire le total. Voyez comment fusionner les sommes partielles et quand la lecture donne un résultat exact.
Version : Java SE 21
Syntaxe
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())Dans Java SE 21, java.util.concurrent.atomic.LongAdder maintient une somme de type long que plusieurs threads peuvent mettre à jour. new LongAdder() part de zéro. increment() ajoute un, comme add(1L). add(long x) ajoute x, qui peut être négatif. Les deux méthodes renvoient void. sum() renvoie un long sans remettre le compteur à zéro.
Dans un LongStream.collect(...) parallèle, LongAdder::new crée de nouveaux conteneurs pour les résultats partiels. La fonction d’accumulation traite chaque élément. La fonction de combinaison (left, right) -> left.add(right.sum()) lit la somme partielle de droite et l’ajoute au conteneur de gauche sans modifier celui de droite. Cette surcharge de collect isole les conteneurs pendant l’accumulation : le parallélisme ne nécessite donc pas à lui seul LongAdder.
Pendant les mises à jour, sum() ne fournit pas d’instantané atomique : la lecture peut ne pas inclure des modifications qui se produisent au même moment. Pour obtenir un résultat final exact, lisez le conteneur renvoyé après la fin de collect, comme dans l’exemple. Si vous gérez vous-même les threads, attendez avec Thread.join() que tous ceux qui mettent à jour le compteur se terminent, et assurez-vous qu’aucun autre thread ne le modifie encore.
Exemples
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());
}
}Résultat
7
Le programme devrait afficher `7`, puisque `1 + 4 + 1 - 2 + 3 = 7`. Le résultat ne dépend pas du découpage du flux et la lecture finale se fait après le retour de `collect`.
Leçons associées
- Java · Leçon 24 · Avancé · Version : 2