WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

LongAccumulator — nebenläufige Aggregation von long-Werten

LongAccumulator aggregiert long-Werte mithilfe einer angegebenen Funktion. Die Klasse unterstützt nebenläufige Aktualisierungen, doch get() liefert während laufender Schreibvorgänge keinen atomaren Schnappschuss des Zustands.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
void accumulate(long x)
long get()

LongAccumulator aus java.util.concurrent.atomic dient der nebenläufigen Aggregation von long-Werten, etwa für Statistiken, nicht zur Steuerung der Synchronisierung. Intern kann die Klasse Aktualisierungen auf mehrere Variablen verteilen und so die Konkurrenz um gemeinsam genutzte Ressourcen auf Kosten des Speicherbedarfs verringern.

Der Konstruktor erhält eine Funktion vom Typ LongBinaryOperator und deren neutrales Element. Die Funktion sollte assoziativ, kommutativ und frei von Seiteneffekten sein: Die Reihenfolge ist nicht garantiert, und die Auswertung kann wiederholt werden. Für Long::max ist Long.MIN_VALUE das neutrale Element.

LongAccumulator.accumulate(long x) bezieht das Argument in die Aggregation ein und gibt void zurück. LongAccumulator.get() gibt das Ergebnis vom Typ long zurück, ist aber kein atomarer Schnappschuss: Gleichzeitige Aktualisierungen können darin fehlen. Ohne gleichzeitige Schreibvorgänge ist das Ergebnis exakt.

Beispiele

import java.util.concurrent.atomic.LongAccumulator;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        LongAccumulator maximum =
                new LongAccumulator(Long::max, Long.MIN_VALUE);

        Thread first = new Thread(() -> {
            maximum.accumulate(-8L);
            maximum.accumulate(12L);
        });
        Thread second = new Thread(() -> {
            maximum.accumulate(7L);
            maximum.accumulate(-3L);
        });

        first.start();
        second.start();
        first.join();
        second.join();

        System.out.println(maximum.get());
    }
}

Ergebnis

12

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen