Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

LongAccumulator: costruzione, aggiornamento e lettura del massimo

Tieni traccia del massimo dei valori `long` con `LongAccumulator`, scegli l’elemento neutro adatto e scopri cosa può restituire `get()` durante gli aggiornamenti concorrenti.

Versione: Java SE 21

Sintassi

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, il costruttore LongAccumulator(LongBinaryOperator,long) del package java.util.concurrent.atomic accetta un operatore e il suo elemento neutro, che è anche il valore iniziale. Un java.util.function.LongBinaryOperator riceve due valori primitivi long e restituisce un long. L’elemento neutro lascia invariato l’input: f(identity, x) == x.

accumulate(long x) integra x nel calcolo tramite l’operatore e non restituisce nulla (void). L’accumulatore può mantenere separati i risultati parziali per ridurre la contesa tra thread. L’ordine di accumulazione non è garantito, quindi usa un operatore associativo e commutativo. Evita gli effetti collaterali: in caso di contesa, l’operatore può essere invocato di nuovo.

Il riferimento al metodo Long::max seleziona il maggiore di due valori. Per coprire l’intero intervallo di long, usa Long.MIN_VALUE, perché max(Long.MIN_VALUE, x) == x. 0L è neutro solo per input non negativi, come le dimensioni. Se sono possibili input negativi, 0L non è un elemento neutro e Java SE 21 non garantisce il risultato se lo usi come tale. Prima del primo aggiornamento, get() restituisce l’elemento neutro: Long.MIN_VALUE da solo non distingue l’assenza di input da un massimo effettivamente uguale a quel valore.

get() combina i risultati parziali e restituisce un long senza azzerare lo stato. Senza aggiornamenti concorrenti il risultato è esatto; altrimenti non è un’istantanea atomica e può non includere alcuni aggiornamenti. Usa la classe per le statistiche, non per coordinare i thread. reset() ripristina l’elemento neutro: chiamalo solo quando nessun thread sta aggiornando l’accumulatore.

Esempi

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

Risultato

-3
-3
0

Due letture dello stesso accumulatore danno `-3` perché `get()` non reimposta lo stato. Il secondo accumulatore restituisce `0` perché riceve anche `0L` come input. Entrambi usano `Long.MIN_VALUE` come elemento neutro.

Lezioni correlate

  • Java · Lezione 31 · Avanzato · Versione: 2

Fonti