CKTIS / Java
LongAccumulator: konštruktor, aktualizácia a čítanie maxima
Udržiavaj priebežné maximum hodnôt `long` pomocou `LongAccumulator`, zvoľ vhodný neutrálny prvok a zisti, čo môže `get()` vrátiť pri súbežných aktualizáciách.
Verzia: Java SE 21
Syntax
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 prijíma konštruktor LongAccumulator(LongBinaryOperator,long) z balíka java.util.concurrent.atomic operátor a jeho neutrálny prvok, ktorý je zároveň počiatočnou hodnotou. java.util.function.LongBinaryOperator prijíma dve primitívne hodnoty long a vracia long. Neutrálny prvok nemení vstup: f(identity, x) == x.
accumulate(long x) zahrnie x do výpočtu pomocou operátora a nič nevracia (void). Akumulátor môže uchovávať čiastkové výsledky oddelene, aby vlákna menej súperili o spoločný stav. Poradie spracovania nie je zaručené, preto použi asociatívny a komutatívny operátor. Vyhni sa vedľajším účinkom: pri súbežných aktualizáciách sa operátor môže zavolať znova.
Odkaz na metódu Long::max vyberie väčšiu z dvoch hodnôt. Pre celý rozsah typu long použi Long.MIN_VALUE, pretože max(Long.MIN_VALUE, x) == x. 0L je neutrálny prvok len pre nezáporné vstupy, napríklad veľkosti. Ak môžu byť vstupy záporné, 0L nie je neutrálny prvok a Java SE 21 nezaručuje výsledok, ak ho tak použiješ. Pred prvou aktualizáciou vracia get() neutrálny prvok. Samotná hodnota Long.MIN_VALUE teda neodlíši chýbajúce vstupy od skutočného maxima rovného tejto hodnote.
get() skombinuje čiastkové výsledky a vráti long bez obnovenia počiatočného stavu. Bez súbežných aktualizácií je výsledok presný; inak nejde o atómovú snímku stavu a niektoré aktualizácie môžu chýbať. Triedu používaj na štatistiky, nie na koordináciu vlákien. reset() obnoví neutrálny prvok; volaj ho iba vtedy, keď žiadne vlákno akumulátor neaktualizuje.
Prí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ýsledok
-3 -3 0
Dve čítania toho istého akumulátora vrátia `-3`, pretože `get()` neobnovuje počiatočný stav. Druhý akumulátor vráti `0`, pretože ako vstup dostane aj `0L`. Oba akumulátory používajú `Long.MIN_VALUE` ako neutrálny prvok.
Súvisiace lekcie
- Java · Lekcia 31 · Pokročilá · Verzia: 2