WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

LongAdder: aktualisieren, auslesen und zurücksetzen

Verwende `LongAdder` für Statistiken, die mehrere Threads aktualisieren. Erfahre, wann das Auslesen genau ist und warum `sumThenReset()` keine atomare Grenze zwischen Messintervallen bildet.

Version: 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 verwaltet eine Summe vom Typ long, die bei null beginnt. Bei vielen konkurrierenden Zugriffen kann die Klasse Aktualisierungen auf mehrere interne Variablen verteilen. Sie eignet sich damit für Statistiken, nicht aber zur Koordination von Threads.

increment() addiert 1, genau wie add(1L). add(long x) addiert den übergebenen Wert, der auch negativ sein darf. Beide Methoden haben den Rückgabetyp void. sum() liefert die Summe als long, ohne sie zu ändern. Ohne gleichzeitige Aktualisierungen ist das Ergebnis genau. Andernfalls ist das Auslesen keine atomare Momentaufnahme und kann gleichzeitige Änderungen übergehen.

reset() setzt dieselbe Instanz auf null zurück und gibt nichts zurück. Verwende die Methode nur, wenn während des Aufrufs kein Thread den Zähler aktualisiert. Ohne gleichzeitige Aktualisierungen wirkt sumThenReset() wie sum() gefolgt von reset(): Die Methode gibt die bisherige Summe als long zurück und setzt den Zähler auf null. Sie bildet keine atomare Grenze zwischen Messintervallen. Bei gleichzeitigen Aktualisierungen muss der Rückgabewert nicht der letzten Summe vor dem Zurücksetzen entsprechen.

Beispiele

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());
    }
}

Ergebnis

Requests: 5
Bytes: 7032
Bytes returned by sumThenReset(): 7032
Bytes after sumThenReset(): 0
Requests after reset(): 0

Ein Thread zählt fünf Anfragen und insgesamt 7032 Bytes. `sumThenReset()` gibt 7032 zurück und setzt den Bytezähler auf null; `reset()` setzt den Anfragezähler auf null, ohne dessen bisherigen Wert zurückzugeben.

Zugehörige Lektionen

  • Java · Lektion 31 · Fortgeschritten · Version: 2

Quellen