CKTIS / Java
AtomicLong — un compteur long atomique
AtomicLong contient une seule valeur long et permet des mises à jour atomiques partagées entre threads. Sa méthode incrementAndGet() augmente la valeur de un et renvoie le résultat mis à jour.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
AtomicLong counter = new AtomicLong(0L);
long updated = counter.incrementAndGet();java.util.concurrent.atomic.AtomicLong est un objet mutable qui contient une seule valeur de type long. Il convient aux compteurs et aux numéros de séquence partagés. Le constructeur new AtomicLong() initialise la valeur à zéro ; new AtomicLong(0L) indique explicitement cette valeur. Ce n’est pas un remplacement d’un objet Long immuable.
AtomicLong.incrementAndGet() effectue la lecture, l’incrémentation de un et l’écriture en une seule opération atomique, puis renvoie la valeur long mise à jour. À l’inverse, getAndIncrement() renvoie la valeur antérieure à l’incrémentation. get() lit la valeur actuelle.
L’atomicité d’une méthode individuelle ne s’étend pas à une séquence arbitraire d’appels : counter.set(counter.get() + 1) n’est pas une incrémentation atomique. Un autre thread peut modifier le compteur entre la lecture et l’écriture. Utilisez counter.incrementAndGet() pour cette mise à jour ; le compteur seul ne protège pas non plus les invariants portant sur plusieurs variables.
Dans l’exemple, deux threads incrémentent chacun 1000 fois le même compteur. Les deux appels à join() ont lieu avant la lecture du résultat : l’ordre d’exécution des threads ne change donc pas la sortie attendue 2000. Périmètre de la documentation : Java SE 21 ; l’environnement d’exécution du dépôt et celui de production ne sont pas attestés.
Exemples
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());
}
}Résultat
2000
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.