KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

LongAccumulator: aanmaken, bijwerken en het maximum uitlezen

Houd met `LongAccumulator` het maximum van `long`-waarden bij, kies een geschikt neutraal element en ontdek wat `get()` bij gelijktijdige updates kan teruggeven.

Versie: 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();

In Java SE 21 verwacht de constructor LongAccumulator(LongBinaryOperator,long) uit java.util.concurrent.atomic een operator en het bijbehorende neutrale element, dat ook de beginwaarde is. Een java.util.function.LongBinaryOperator verwerkt twee primitieve long-waarden en geeft een long terug. Een neutraal element laat de invoer ongewijzigd: f(identity, x) == x.

accumulate(long x) verwerkt x met de operator en geeft niets terug (void). De accumulator kan deelresultaten apart bijhouden om concurrentie tussen threads om gedeelde opslag te verminderen. De volgorde van verwerken is niet gegarandeerd, dus kies een associatieve en commutatieve operator. Vermijd neveneffecten: bij concurrerende updates kan de operator opnieuw worden aangeroepen.

De methodereferentie Long::max kiest de grootste van twee waarden. Gebruik voor het volledige long-bereik Long.MIN_VALUE, want max(Long.MIN_VALUE, x) == x. 0L is alleen neutraal voor niet-negatieve invoer, zoals groottes. Als de invoer negatief kan zijn, is 0L geen neutraal element en garandeert Java SE 21 het resultaat niet als je het toch zo gebruikt. Vóór de eerste update geeft get() het neutrale element terug. Aan Long.MIN_VALUE alleen kun je dus niet zien of er geen invoer was of dat dit echt het maximum is.

get() combineert de deelresultaten en geeft een long terug zonder de toestand te resetten. Zonder gelijktijdige updates is het resultaat exact; anders is het geen atomaire momentopname en kunnen updates ontbreken. Gebruik de klasse voor statistieken, niet voor coördinatie tussen threads. reset() herstelt het neutrale element; roep die methode alleen aan als geen enkele thread de accumulator bijwerkt.

Voorbeelden

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());
    }
}

Resultaat

-3
-3
0

Twee uitlezingen van dezelfde accumulator geven `-3`, want `get()` reset de toestand niet. De tweede accumulator geeft `0` terug omdat die ook `0L` als invoer krijgt. Beide accumulators gebruiken `Long.MIN_VALUE` als neutraal element.

Gerelateerde lessen

  • Java · Les 31 · Gevorderd · Versie: 2

Bronnen