CKTIS / Java
LongAdder: bijwerken, uitlezen en op nul zetten
Gebruik `LongAdder` voor statistieken die door meerdere threads worden bijgewerkt. Leer wanneer de uitgelezen som exact is en waarom `sumThenReset()` geen atomaire grens tussen meetperiodes vormt.
Versie: 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 houdt een totaal van het type long bij dat op nul begint. Als veel threads tegelijk willen bijwerken, kan de klasse updates over meerdere interne variabelen verdelen. Dat is handig voor statistieken, niet voor het coördineren van threads.
increment() telt er 1 bij, net als add(1L). add(long x) telt de opgegeven waarde erbij; die mag negatief zijn. Beide methoden hebben retourtype void. sum() retourneert het totaal als long zonder het te wijzigen. Zonder gelijktijdige updates is het resultaat exact. Anders is de uitlezing geen atomaire momentopname en kan die sommige gelijktijdige updates missen.
reset() zet dezelfde instantie op nul en retourneert niets. Gebruik deze methode alleen als je weet dat geen enkele thread de teller tijdens de aanroep bijwerkt. Zonder gelijktijdige updates heeft sumThenReset() hetzelfde effect als eerst sum() en daarna reset() aanroepen: de methode retourneert het vorige totaal als long en zet de teller op nul. Dit is geen atomaire grens tussen meetperiodes. Als updates samenvallen met de aanroep, is de geretourneerde waarde niet gegarandeerd het laatste totaal vóór het op nul zetten.
Voorbeelden
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());
}
}Resultaat
Requests: 5 Bytes: 7032 Bytes returned by sumThenReset(): 7032 Bytes after sumThenReset(): 0 Requests after reset(): 0
Eén thread telt vijf verzoeken en in totaal 7032 bytes. `sumThenReset()` retourneert 7032 en zet de byteteller op nul; `reset()` zet de verzoekteller op nul zonder de vorige waarde te retourneren.
Gerelateerde lessen
- Java · Les 31 · Gevorderd · Versie: 2