CKTIS / Java
LongAdder : mettre à jour, lire et remettre à zéro
Utilisez `LongAdder` pour des statistiques mises à jour par plusieurs threads. Découvrez quand la lecture est exacte et pourquoi `sumThenReset()` ne sépare pas deux périodes de mesure de façon atomique.
Version : Java SE 21
Syntaxe
import java.util.concurrent.atomic.LongAdder;
// LongAdder instance methods in Java SE 21:
public void increment()
public void add(long x)
public long sum()
public long sumThenReset()
public void reset()java.util.concurrent.atomic.LongAdder maintient un total de type long, initialement nul. Lorsque de nombreux threads se disputent l’accès au compteur, la classe peut répartir les mises à jour entre plusieurs variables internes. Elle convient aux statistiques, pas à la coordination des threads.
increment() ajoute 1, comme add(1L). add(long x) ajoute la valeur fournie, qui peut être négative. Les deux méthodes ont pour type de retour void. sum() renvoie le total sous forme de long sans le modifier. Le résultat est exact en l’absence de mises à jour concurrentes. Sinon, la lecture n’est pas un instantané atomique et peut omettre certaines de ces mises à jour.
reset() remet la même instance à zéro et ne renvoie rien. Ne l’utilisez que si aucun thread ne met le compteur à jour pendant l’appel. Sans mises à jour concurrentes, sumThenReset() produit le même effet que sum() suivi de reset() : la méthode renvoie l’ancien total sous forme de long et remet le compteur à zéro. Elle ne délimite pas les périodes de mesure de façon atomique. Si des mises à jour chevauchent l’appel, le résultat ne correspond pas forcément au dernier total avant la remise à zéro.
Exemples
import java.util.concurrent.atomic.LongAdder;
public class Main {
public static void main(String[] args) {
LongAdder requests = new LongAdder();
LongAdder bytes = new LongAdder();
for (long size : new long[] {512L, 1024L, 2048L, 3072L, 376L}) {
requests.increment();
bytes.add(size);
}
System.out.println("Requests: " + requests.sum());
System.out.println("Bytes: " + bytes.sum());
System.out.println("Bytes returned by sumThenReset(): " + bytes.sumThenReset());
System.out.println("Bytes after sumThenReset(): " + bytes.sum());
requests.reset();
System.out.println("Requests after reset(): " + requests.sum());
}
}Résultat
Requests: 5 Bytes: 7032 Bytes returned by sumThenReset(): 7032 Bytes after sumThenReset(): 0 Requests after reset(): 0
Un seul thread compte cinq requêtes et un total de 7032 octets. `sumThenReset()` renvoie 7032 et remet le compteur d’octets à zéro ; `reset()` remet le compteur de requêtes à zéro sans renvoyer son ancienne valeur.
Leçons associées
- Java · Leçon 31 · Avancé · Version : 2