CKTIS / Java
LongAdder: aktualizácia, čítanie a vynulovanie
Používaj `LongAdder` na zber štatistík aktualizovaných viacerými vláknami. Zisti, kedy je prečítaný súčet presný a prečo `sumThenReset()` netvorí atómovú hranicu medzi intervalmi merania.
Verzia: Java SE 21
Syntax
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 udržiava súčet typu long, ktorý začína na nule. Keď o aktualizáciu súperí veľa vlákien, môže aktualizácie rozdeliť medzi viacero interných premenných. Hodí sa na zber štatistík, nie na koordináciu vlákien.
increment() pripočíta 1 rovnako ako add(1L). add(long x) pripočíta zadanú hodnotu, ktorá môže byť aj záporná. Obe metódy majú návratový typ void. sum() vráti súčet ako long bez toho, aby ho zmenila. Bez súbežných aktualizácií je výsledok presný. Inak čítanie neposkytuje atómovú snímku a môže vynechať niektoré súbežné aktualizácie.
reset() vynuluje tú istú inštanciu a nič nevracia. Používaj túto metódu iba vtedy, keď vieš, že počas volania žiadne vlákno počítadlo neaktualizuje. Bez súbežných aktualizácií má sumThenReset() rovnaký účinok ako volanie sum() a potom reset(): vráti doterajší súčet ako long a vynuluje počítadlo. Netvorí atómovú hranicu medzi intervalmi merania. Ak aktualizácie prebiehajú počas volania, vrátená hodnota nemusí zodpovedať poslednému súčtu pred vynulovaním.
Príklady
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());
}
}Výsledok
Requests: 5 Bytes: 7032 Bytes returned by sumThenReset(): 7032 Bytes after sumThenReset(): 0 Requests after reset(): 0
Jedno vlákno napočíta päť požiadaviek a celkovo 7032 bajtov. `sumThenReset()` vráti 7032 a vynuluje počítadlo bajtov; `reset()` vynuluje počítadlo požiadaviek bez vrátenia jeho predchádzajúcej hodnoty.
Súvisiace lekcie
- Java · Lekcia 31 · Pokročilá · Verzia: 2