CKTIS / Java
LongAdder — konkurentno brojanje i zbrajanje
LongAdder prikuplja zbroj tipa long koji ažurira više dretvi. Prikladan je za statistiku, ali sum() ne daje atomsku snimku, a za poništavanje je potrebno kontrolirati konkurentna ažuriranja.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
LongAdder counter = new LongAdder();
counter.increment(); // void
counter.add(longValue); // void
long total = counter.sum();
long previous = counter.sumThenReset();
counter.reset(); // voidjava.util.concurrent.atomic.LongAdder počinje od nule i raspoređuje ažuriranja na interne varijable kako bi smanjio nadmetanje među dretvama. Pri velikom nadmetanju može ostvariti veću propusnost od AtomicLong, uz veću potrošnju memorije. Upotrebljavajte ga za statistiku, a ne za precizno upravljanje sinkronizacijom.
LongAdder.increment() dodaje jedan, a LongAdder.add(long) dodaje zadanu vrijednost; obje metode vraćaju void. LongAdder.sum() vraća long, ali ne daje atomsku snimku: možda neće obuhvatiti ažuriranja koja se odvijaju tijekom čitanja. Ako nema konkurentnih ažuriranja, rezultat je točan.
LongAdder.reset() poništava stanje i vraća void; upotrebljavajte je samo kada nijedna dretva ne ažurira brojač. LongAdder.sumThenReset() vraća zbroj i poništava stanje. Nemojte je smatrati atomskom granicom mjernog razdoblja: uz konkurentna ažuriranja rezultat ne mora biti konačna vrijednost prije poništavanja.
U primjeru oba poziva join() prethode čitanju i poništavanju. Zato je očekivani izlaz determinističan. Dokumentacija se odnosi na Java SE 21; izvršno okruženje repozitorija ne potvrđuje produkcijsko izvršno okruženje.
Primjeri
import java.util.concurrent.atomic.LongAdder;
public class Main {
public static void main(String[] args) throws InterruptedException {
LongAdder counter = new LongAdder();
Runnable task = () -> {
for (int i = 0; i < 1000; i++) {
counter.increment();
}
};
Thread first = new Thread(task);
Thread second = new Thread(task);
first.start();
second.start();
first.join();
second.join();
counter.add(5);
System.out.println(counter.sum());
System.out.println(counter.sumThenReset());
System.out.println(counter.sum());
counter.add(7);
counter.reset();
System.out.println(counter.sum());
}
}Rezultat
2005 2005 0 0
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.