CKTIS / Java
LongAccumulator: konstruktor, ažuriranje i čitanje maksimuma
Prati tekući maksimum vrijednosti `long` uz `LongAccumulator`, odaberi prikladan neutralni element i saznaj što `get()` može vratiti tijekom istodobnih ažuriranja.
Verzija: 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();U izdanju Java SE 21 konstruktor LongAccumulator(LongBinaryOperator,long) iz paketa java.util.concurrent.atomic prima operator i njegov neutralni element, koji je ujedno početna vrijednost. java.util.function.LongBinaryOperator prima dvije primitivne vrijednosti long i vraća long. Neutralni element ne mijenja ulaz: f(identity, x) == x.
accumulate(long x) uključuje x u izračun pomoću operatora i ne vraća vrijednost (void). Akumulator može zasebno čuvati djelomične rezultate kako bi se dretve manje natjecale za zajedničko stanje. Redoslijed obrade nije zajamčen, stoga koristi asocijativan i komutativan operator. Izbjegavaj nuspojave: pri natjecanju dretvi operator se može ponovno pozvati.
Referenca na metodu Long::max odabire veću od dviju vrijednosti. Za cijeli raspon tipa long koristi Long.MIN_VALUE jer vrijedi max(Long.MIN_VALUE, x) == x. 0L je neutralan samo za nenegativne ulaze, primjerice veličine. Ako su mogući negativni ulazi, 0L nije neutralni element i Java SE 21 ne jamči rezultat ako ga ipak upotrijebiš u toj ulozi. Prije prvog ažuriranja get() vraća neutralni element. Sama vrijednost Long.MIN_VALUE zato ne razlikuje izostanak ulaza od stvarnog maksimuma koji je jednak toj vrijednosti.
get() spaja djelomične rezultate i vraća long bez vraćanja stanja na početnu vrijednost. Bez istodobnih ažuriranja rezultat je točan; inače očitanje nije atomska snimka stanja i može izostaviti neka ažuriranja. Koristi klasu za statistiku, a ne za koordinaciju dretvi. reset() vraća neutralni element; pozovi ga samo kada nijedna dretva ne ažurira akumulator.
Primjeri
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
Dva čitanja istog akumulatora daju `-3` jer `get()` ne vraća stanje na početnu vrijednost. Drugi akumulator vraća `0` jer kao ulaz prima i `0L`. Oba akumulatora koriste `Long.MIN_VALUE` kao neutralni element.
Povezane lekcije
- Java · Lekcija 31 · Napredno · Verzija: 2