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.