CKTIS / Java
LongAdder: aktualizace, čtení a vynulování
Používej `LongAdder` pro statistiky aktualizované více vlákny. Zjisti, kdy je přečtený součet přesný a proč `sumThenReset()` netvoří atomickou hranici mezi intervaly měření.
Verze: Java SE 21
Syntaxe
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žuje součet typu long, který začíná na nule. Když o aktualizaci soupeří mnoho vláken, může aktualizace rozložit mezi více vnitřních proměnných. Hodí se pro sběr statistik, ne pro koordinaci vláken.
increment() přičte 1 stejně jako add(1L). add(long x) přičte zadanou hodnotu, která může být i záporná. Obě metody mají návratový typ void. sum() vrátí součet jako long, aniž by ho změnila. Bez souběžných aktualizací je výsledek přesný. Jinak čtení neposkytuje atomický snímek a může některé souběžné aktualizace vynechat.
reset() vynuluje tutéž instanci a nic nevrací. Používej tuto metodu jen tehdy, když víš, že během jejího volání žádné vlákno čítač neaktualizuje. Bez souběžných aktualizací má sumThenReset() stejný účinek jako volání sum() a pak reset(): vrátí dosavadní součet jako long a čítač vynuluje. Netvoří atomickou hranici mezi intervaly měření. Pokud se aktualizace překrývají s voláním, vrácená hodnota nemusí odpovídat poslednímu součtu před vynulováním.
Pří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ýsledek
Requests: 5 Bytes: 7032 Bytes returned by sumThenReset(): 7032 Bytes after sumThenReset(): 0 Requests after reset(): 0
Jedno vlákno napočítá pět požadavků a celkem 7032 bajtů. `sumThenReset()` vrátí 7032 a vynuluje čítač bajtů; `reset()` vynuluje čítač požadavků, aniž by vrátila jeho předchozí hodnotu.
Související lekce
- Java · Lekce 31 · Pokročilá · Verze: 2