CKTIS / Java
LongAccumulator — súbežná agregácia hodnôt long
LongAccumulator kombinuje hodnoty long pomocou zadanej funkcie. Podporuje súbežné aktualizácie, ale get() počas ich vykonávania neposkytuje atómový snímok stavu.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
void accumulate(long x)
long get()LongAccumulator z balíka java.util.concurrent.atomic slúži na súbežnú agregáciu hodnôt long, napríklad na výpočet štatistík, nie na riadenie synchronizácie. Interne môže rozdeľovať aktualizácie medzi viacero premenných, čím znižuje súperenie za cenu vyššej spotreby pamäte.
Konštruktor prijíma funkciu LongBinaryOperator a jej neutrálny prvok. Funkcia by mala byť asociatívna, komutatívna a bez vedľajších účinkov: poradie nie je zaručené a výpočet sa môže opakovať. Pre Long::max je neutrálnym prvkom Long.MIN_VALUE.
LongAccumulator.accumulate(long x) zahrnie argument do agregácie a vracia void. LongAccumulator.get() vracia výsledok typu long, ale nejde o atómový snímok stavu: súbežné aktualizácie v ňom môžu chýbať. Ak neprebiehajú súbežné zápisy, výsledok je presný.
Prí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ýsledok
12
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.