KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen