CKTIS / Java
LongAdder — souběžné počítání a sčítání
LongAdder shromažďuje součet typu long, který aktualizuje více vláken. Hodí se pro statistiky, ale sum() neposkytuje atomický snímek a při vynulování je nutné mít pod kontrolou souběžné aktualizace.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 začíná na nule a rozděluje aktualizace mezi interní proměnné, čímž omezuje soupeření mezi vlákny. Při vysokém soupeření může nabídnout vyšší propustnost než AtomicLong, ovšem za cenu větší spotřeby paměti. Používejte jej pro statistiky, ne pro přesné řízení synchronizace.
LongAdder.increment() přičte jedničku a LongAdder.add(long) přičte zadanou hodnotu; obě metody vracejí void. LongAdder.sum() vrací long, ale neposkytuje atomický snímek: nemusí zahrnout aktualizace probíhající během čtení. Pokud neprobíhají souběžné aktualizace, je výsledek přesný.
LongAdder.reset() vynuluje stav a vrací void; použijte ji pouze tehdy, když žádné vlákno čítač neaktualizuje. LongAdder.sumThenReset() vrátí součet a vynuluje stav. Nepovažujte ji za atomickou hranici měřicího období: při souběžných aktualizacích nemusí výsledek odpovídat konečné hodnotě před vynulováním.
V příkladu obě volání join() předcházejí čtení a vynulování. Očekávaný výstup je proto deterministický. Dokumentace se vztahuje k Java SE 21; běhové prostředí repozitáře nepotvrzuje produkční běhové prostředí.
Příklady
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());
}
}Výsledek
2005 2005 0 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.