Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje