Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

LongAccumulator — aggregazione concorrente di valori long

LongAccumulator combina valori long usando una funzione fornita. Supporta aggiornamenti concorrenti, ma get() non fornisce uno snapshot atomico dello stato mentre gli aggiornamenti sono in corso.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
void accumulate(long x)
long get()

LongAccumulator, nel pacchetto java.util.concurrent.atomic, consente di aggregare valori long in modo concorrente, per esempio per calcolare statistiche, anziché controllare la sincronizzazione. Internamente può distribuire gli aggiornamenti su più variabili, riducendo la contesa a costo di una maggiore occupazione di memoria.

Il costruttore riceve una funzione LongBinaryOperator e il suo elemento neutro. La funzione dovrebbe essere associativa, commutativa e priva di effetti collaterali: l’ordine non è garantito e la valutazione può essere ripetuta. Per Long::max, l’elemento neutro è Long.MIN_VALUE.

LongAccumulator.accumulate(long x) include l’argomento nell’aggregazione e restituisce void. LongAccumulator.get() restituisce il risultato di tipo long, ma non è uno snapshot atomico: potrebbe non includere aggiornamenti concorrenti. In assenza di aggiornamenti concorrenti, il risultato è esatto.

Esempi

import java.util.concurrent.atomic.LongAccumulator;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        LongAccumulator maximum =
                new LongAccumulator(Long::max, Long.MIN_VALUE);

        Thread first = new Thread(() -> {
            maximum.accumulate(-8L);
            maximum.accumulate(12L);
        });
        Thread second = new Thread(() -> {
            maximum.accumulate(7L);
            maximum.accumulate(-3L);
        });

        first.start();
        second.start();
        first.join();
        second.join();

        System.out.println(maximum.get());
    }
}

Risultato

12

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti