CKTIS / Java
LongAdder: Zähler erhöhen, Werte addieren und die Summe lesen
Mit `increment()` erhöhst du den Zähler um eins, mit `add(long)` addierst du eine Änderung und mit `sum()` liest du die Summe. Lerne, wie Teilsummen zusammengeführt werden und wann das Ergebnis exakt ist.
Version: Java SE 21
Syntax
Java SE 21 — java.util.concurrent.atomic.LongAdder
public LongAdder()
public void increment()
public void add(long x)
public long sum()
LongStream.collect: (left, right) -> left.add(right.sum())In Java SE 21 verwaltet java.util.concurrent.atomic.LongAdder eine Summe vom Typ long, die mehrere Threads aktualisieren können. new LongAdder() startet bei null. increment() erhöht die Summe um eins und ist gleichbedeutend mit add(1L). add(long x) addiert x, das auch negativ sein darf. Beide Methoden geben void zurück. sum() liefert einen long-Wert, ohne den Zähler zurückzusetzen.
Bei einem parallelen LongStream.collect(...) erzeugt LongAdder::new neue Container für Teilergebnisse. Die Akkumulationsfunktion verarbeitet jedes Element. Die Kombinationsfunktion (left, right) -> left.add(right.sum()) liest die rechte Teilsumme und addiert sie zum linken Container, ohne den rechten zu ändern. Diese Überladung von collect hält die Container beim Akkumulieren getrennt; allein für die parallele Ausführung ist LongAdder daher nicht nötig.
Während laufender Aktualisierungen liefert sum() keine atomare Momentaufnahme: Änderungen während des Lesens können fehlen. Lies den zurückgegebenen Container für ein exaktes Endergebnis erst nach Abschluss von collect, wie im Beispiel. Wenn du die Threads selbst verwaltest, warte mit Thread.join() auf das Ende aller aktualisierenden Threads und stelle sicher, dass kein anderer Thread den Zähler noch ändert.
Beispiele
import java.util.concurrent.atomic.LongAdder;
import java.util.stream.LongStream;
public class LongAdderDemo {
public static void main(String[] args) {
LongAdder total = LongStream.of(1, 4, 1, -2, 3)
.parallel()
.collect(LongAdder::new,
(partial, delta) -> {
if (delta == 1L) {
partial.increment();
} else {
partial.add(delta);
}
},
(left, right) -> left.add(right.sum()));
System.out.println(total.sum());
}
}Ergebnis
7
Das erwartete Ergebnis ist `7`, denn `1 + 4 + 1 - 2 + 3 = 7`. Es hängt nicht von der Aufteilung des Streams ab, und der abschließende Lesezugriff erfolgt nach der Rückkehr von `collect`.
Zugehörige Lektionen
- Java · Lektion 24 · Fortgeschritten · Version: 2