CKTIS / Java
LongAccumulator: konstruktor, aktualizace a čtení maxima
Udržuj průběžné maximum hodnot `long` pomocí `LongAccumulator`, zvol správný neutrální prvek a zjisti, co může `get()` vrátit při souběžných aktualizacích.
Verze: Java SE 21
Syntaxe
import java.util.concurrent.atomic.LongAccumulator;
import java.util.function.LongBinaryOperator;
// API signatures
public LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
public void accumulate(long x)
public long get()
// Running maximum over the full long range
LongAccumulator maximum = new LongAccumulator(Long::max, Long.MIN_VALUE);
maximum.accumulate(-7L);
long currentMaximum = maximum.get();V Java SE 21 přijímá konstruktor LongAccumulator(LongBinaryOperator,long) z balíčku java.util.concurrent.atomic operátor a jeho neutrální prvek, který je zároveň počáteční hodnotou. java.util.function.LongBinaryOperator přijímá dvě primitivní hodnoty long a vrací long. Neutrální prvek nemění vstup: f(identity, x) == x.
accumulate(long x) zahrne x do výpočtu pomocí operátoru a nic nevrací (void). Akumulátor může uchovávat dílčí výsledky odděleně, aby vlákna méně soupeřila o sdílený stav. Pořadí zpracování není zaručeno, proto použij asociativní a komutativní operátor. Vyhni se vedlejším účinkům: při souběžných aktualizacích může být operátor zavolán opakovaně.
Odkaz na metodu Long::max vybere větší ze dvou hodnot. Pro celý rozsah typu long použij Long.MIN_VALUE, protože max(Long.MIN_VALUE, x) == x. 0L je neutrální pouze pro nezáporné vstupy, například velikosti. Pokud mohou být vstupy záporné, 0L není neutrální prvek a Java SE 21 nezaručuje výsledek, pokud ho v této roli použiješ. Před první aktualizací vrací get() neutrální prvek. Samotná hodnota Long.MIN_VALUE tedy neodliší chybějící vstupy od skutečného maxima rovného této hodnotě.
get() spojí dílčí výsledky a vrátí long, aniž by obnovil počáteční stav. Bez souběžných aktualizací je výsledek přesný; jinak nejde o atomický snímek stavu a některé aktualizace v něm mohou chybět. Třídu používej pro statistiky, ne ke koordinaci vláken. reset() obnoví neutrální prvek; volej ho pouze tehdy, když žádné vlákno akumulátor neaktualizuje.
Příklady
import java.util.concurrent.atomic.LongAccumulator;
public class Main {
public static void main(String[] args) {
LongAccumulator fullRange = new LongAccumulator(Long::max, Long.MIN_VALUE);
LongAccumulator withZero = new LongAccumulator(Long::max, Long.MIN_VALUE);
withZero.accumulate(0L);
for (long value : new long[] {-7L, -3L, -12L}) {
fullRange.accumulate(value);
withZero.accumulate(value);
}
System.out.println(fullRange.get());
System.out.println(fullRange.get());
System.out.println(withZero.get());
}
}Výsledek
-3 -3 0
Dvě čtení téhož akumulátoru vrátí `-3`, protože `get()` neobnovuje počáteční stav. Druhý akumulátor vrátí `0`, protože jako vstup dostane navíc `0L`. Oba akumulátory používají `Long.MIN_VALUE` jako neutrální prvek.
Související lekce
- Java · Lekce 31 · Pokročilá · Verze: 2