Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources