CKTIS / Java
LongAdder — súbežné počítanie a sčítanie
LongAdder zhromažďuje súčet typu long, ktorý aktualizuje viacero vlákien. Hodí sa na štatistiky, ale sum() neposkytuje atómový snímok a pri vynulovaní treba mať pod kontrolou súbežné aktualizácie.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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čína na nule a rozdeľuje aktualizácie medzi interné premenné, čím obmedzuje súperenie medzi vláknami. Pri vysokej miere súperenia môže ponúknuť vyššiu priepustnosť než AtomicLong, za cenu väčšej spotreby pamäte. Používajte ho na štatistiky, nie na presné riadenie synchronizácie.
LongAdder.increment() pripočíta jednotku a LongAdder.add(long) pripočíta zadanú hodnotu; obe metódy vracajú void. LongAdder.sum() vracia long, ale neposkytuje atómový snímok: nemusí zahŕňať aktualizácie prebiehajúce počas čítania. Ak neprebiehajú súbežné aktualizácie, výsledok je presný.
LongAdder.reset() vynuluje stav a vracia void; použite ju iba vtedy, keď žiadne vlákno neaktualizuje počítadlo. LongAdder.sumThenReset() vráti súčet a vynuluje stav. Nepovažujte ju za atómovú hranicu meracieho obdobia: pri súbežných aktualizáciách nemusí výsledok zodpovedať konečnej hodnote pred vynulovaním.
V príklade obe volania join() predchádzajú čítaniu a vynulovaniu. Očakávaný výstup je preto deterministický. Dokumentácia sa vzťahuje na Java SE 21; behové prostredie repozitára nepotvrdzuje produkčné behové prostredie.
Prí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ýsledok
2005 2005 0 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.