Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

LongAccumulator — souběžná agregace hodnot long

LongAccumulator kombinuje hodnoty long pomocí zadané funkce. Podporuje souběžné aktualizace, ale get() během jejich provádění neposkytuje atomický snímek stavu.

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

Syntaxe

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

LongAccumulator z balíčku java.util.concurrent.atomic slouží k souběžné agregaci hodnot long, například pro výpočet statistik, nikoli k řízení synchronizace. Interně může rozdělovat aktualizace mezi více proměnných, čímž omezuje soupeření za cenu vyšší spotřeby paměti.

Konstruktor přijímá funkci LongBinaryOperator a její neutrální prvek. Funkce by měla být asociativní, komutativní a bez vedlejších účinků: pořadí není zaručeno a výpočet se může opakovat. Pro Long::max je neutrálním prvkem Long.MIN_VALUE.

LongAccumulator.accumulate(long x) zahrne argument do agregace a vrací void. LongAccumulator.get() vrací výsledek typu long, ale nejde o atomický snímek stavu: souběžné aktualizace v něm mohou chybět. Pokud neprobíhají souběžné zápisy, je výsledek přesný.

Příklady

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

Výsledek

12

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje