CKTIS / Java
LongAccumulator — gelijktijdige aggregatie van long-waarden
LongAccumulator combineert long-waarden met een opgegeven functie. De klasse ondersteunt gelijktijdige updates, maar get() levert geen atomische momentopname van de toestand terwijl updates plaatsvinden.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
void accumulate(long x)
long get()LongAccumulator uit java.util.concurrent.atomic is bedoeld voor gelijktijdige aggregatie van long-waarden, bijvoorbeeld voor statistieken, en niet voor het regelen van synchronisatie. Intern kan de klasse updates over meerdere variabelen verdelen, waardoor de contention afneemt ten koste van extra geheugen.
De constructor krijgt een functie van het type LongBinaryOperator en het neutrale element daarvan. De functie hoort associatief, commutatief en vrij van neveneffecten te zijn: de volgorde is niet gegarandeerd en de evaluatie kan worden herhaald. Voor Long::max is Long.MIN_VALUE het neutrale element.
LongAccumulator.accumulate(long x) neemt het argument op in de aggregatie en retourneert void. LongAccumulator.get() retourneert het resultaat van het type long, maar is geen atomische momentopname: gelijktijdige updates kunnen ontbreken. Zonder gelijktijdige updates is het resultaat exact.
Voorbeelden
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());
}
}Resultaat
12
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.