CKTIS / Java
LongAccumulator: Konstruktor, Aktualisieren und Ablesen des Maximums
Ermittle mit `LongAccumulator` das laufende Maximum von `long`-Werten. Wähle ein passendes neutrales Element und beachte, was `get()` bei gleichzeitigen Aktualisierungen liefert.
Version: Java SE 21
Syntax
import java.util.concurrent.atomic.LongAccumulator;
import java.util.function.LongBinaryOperator;
// API signatures
public LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
public void accumulate(long x)
public long get()
// Running maximum over the full long range
LongAccumulator maximum = new LongAccumulator(Long::max, Long.MIN_VALUE);
maximum.accumulate(-7L);
long currentMaximum = maximum.get();In Java SE 21 erwartet der Konstruktor LongAccumulator(LongBinaryOperator,long) aus dem Paket java.util.concurrent.atomic einen Operator und dessen neutrales Element, das zugleich der Startwert ist. Ein java.util.function.LongBinaryOperator verarbeitet zwei primitive long-Werte und liefert einen long-Wert. Das neutrale Element lässt einen Eingabewert unverändert: f(identity, x) == x.
accumulate(long x) übernimmt x mithilfe des Operators und hat keinen Rückgabewert (void). Um Konkurrenz zwischen Threads zu verringern, kann der Akkumulator Teilergebnisse getrennt halten. Da die Reihenfolge nicht garantiert ist, sollte der Operator assoziativ und kommutativ sein. Er sollte keine Seiteneffekte haben, da er bei konkurrierenden Aktualisierungen erneut aufgerufen werden kann.
Die Methodenreferenz Long::max wählt den größeren von zwei Werten. Für den gesamten long-Wertebereich gilt mit Long.MIN_VALUE: max(Long.MIN_VALUE, x) == x. 0L ist nur für nichtnegative Eingaben wie Größen neutral. Sind negative Eingaben möglich, ist 0L kein neutrales Element, und Java SE 21 garantiert kein Ergebnis, wenn du es dennoch als solches übergibst. Vor der ersten Aktualisierung liefert get() das neutrale Element. An Long.MIN_VALUE allein ist daher nicht erkennbar, ob noch keine Eingaben vorliegen oder ob dies tatsächlich das Maximum ist.
get() fasst die Teilergebnisse zu einem long-Wert zusammen, ohne den Zustand zurückzusetzen. Ohne gleichzeitige Aktualisierungen ist das Ergebnis korrekt; andernfalls ist es keine atomare Momentaufnahme und kann einzelne Aktualisierungen auslassen. Nutze die Klasse für Statistiken, nicht zur Koordination von Threads. reset() stellt das neutrale Element wieder her und darf nur aufgerufen werden, wenn kein Thread den Akkumulator aktualisiert.
Beispiele
import java.util.concurrent.atomic.LongAccumulator;
public class Main {
public static void main(String[] args) {
LongAccumulator fullRange = new LongAccumulator(Long::max, Long.MIN_VALUE);
LongAccumulator withZero = new LongAccumulator(Long::max, Long.MIN_VALUE);
withZero.accumulate(0L);
for (long value : new long[] {-7L, -3L, -12L}) {
fullRange.accumulate(value);
withZero.accumulate(value);
}
System.out.println(fullRange.get());
System.out.println(fullRange.get());
System.out.println(withZero.get());
}
}Ergebnis
-3 -3 0
Zwei Lesezugriffe auf denselben Akkumulator ergeben `-3`, weil `get()` den Zustand nicht zurücksetzt. Der zweite Akkumulator liefert `0`, weil er zusätzlich `0L` als Eingabe erhält. Beide verwenden `Long.MIN_VALUE` als neutrales Element.
Zugehörige Lektionen
- Java · Lektion 31 · Fortgeschritten · Version: 2