CKTIS / Java
LongAccumulator: konstruktor, posodabljanje in branje maksimuma
Z razredom `LongAccumulator` spremljaj tekoči maksimum vrednosti `long`, izberi ustrezen nevtralni element in ugotovi, kaj lahko `get()` vrne med sočasnimi posodobitvami.
Različica: Java SE 21
Sintaksa
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 konstruktor LongAccumulator(LongBinaryOperator,long) iz paketa java.util.concurrent.atomic sprejme operator in njegov nevtralni element, ki je tudi začetna vrednost. java.util.function.LongBinaryOperator sprejme dve primitivni vrednosti long in vrne long. Nevtralni element vhoda ne spremeni: f(identity, x) == x.
accumulate(long x) z operatorjem vključi x v izračun in ne vrne vrednosti (void). Akumulator lahko hrani delne rezultate ločeno, da niti manj tekmujejo za skupno stanje. Vrstni red obdelave ni zagotovljen, zato uporabi asociativen in komutativen operator. Izogibaj se stranskim učinkom: ob tekmovanju med nitmi se operator lahko pokliče znova.
Referenca na metodo Long::max izbere večjo od dveh vrednosti. Za celoten razpon tipa long uporabi Long.MIN_VALUE, saj velja max(Long.MIN_VALUE, x) == x. 0L je nevtralen le za nenegativne vhode, kot so velikosti. Če so možni negativni vhodi, 0L ni nevtralni element in Java SE 21 ne zagotavlja rezultata, če ga uporabiš v tej vlogi. Pred prvo posodobitvijo get() vrne nevtralni element, zato samo iz vrednosti Long.MIN_VALUE ne moreš ugotoviti, ali vhodov še ni bilo ali pa je to dejanski maksimum.
get() združi delne rezultate in vrne long, ne da bi ponastavil stanje. Brez sočasnih posodobitev je rezultat točen; sicer branje ni atomski posnetek stanja in lahko izpusti nekatere posodobitve. Razred uporabljaj za statistiko, ne za usklajevanje niti. reset() obnovi nevtralni element; pokliči ga le, ko nobena nit ne posodablja akumulatorja.
Primeri
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());
}
}Rezultat
-3 -3 0
Dve branji istega akumulatorja vrneta `-3`, ker `get()` ne ponastavi stanja. Drugi akumulator vrne `0`, ker kot vhod prejme tudi `0L`. Oba akumulatorja uporabljata `Long.MIN_VALUE` kot nevtralni element.
Povezane lekcije
- Java · Lekcija 31 · Napredna · Različica: 2