Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori