Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

LongAdder: aggiornare, leggere e azzerare

Usa `LongAdder` per raccogliere statistiche aggiornate da più thread. Scopri quando la lettura restituisce un valore esatto e perché `sumThenReset()` non separa atomicamente gli intervalli di misurazione.

Versione: Java SE 21

Sintassi

import java.util.concurrent.atomic.LongAdder;

// LongAdder instance methods in Java SE 21:
public void increment()
public void add(long x)
public long sum()
public long sumThenReset()
public void reset()

java.util.concurrent.atomic.LongAdder mantiene un totale di tipo long che parte da zero. In caso di forte contesa tra thread, può distribuire gli aggiornamenti su più variabili interne. È adatto a raccogliere statistiche, non a coordinare i thread.

increment() aggiunge 1, come add(1L). add(long x) aggiunge il valore specificato, che può anche essere negativo. Entrambi i metodi hanno tipo di ritorno void. sum() restituisce il totale come long senza modificarlo. In assenza di aggiornamenti concorrenti il risultato è esatto. Altrimenti la lettura non è un’istantanea atomica e può non includere alcuni aggiornamenti concorrenti.

reset() azzera la stessa istanza e non restituisce alcun valore. Usalo solo se sai che nessun thread aggiornerà il contatore durante la chiamata. Senza aggiornamenti concorrenti, sumThenReset() ha lo stesso effetto di sum() seguito da reset(): restituisce il totale precedente come long e azzera il contatore. Non separa atomicamente gli intervalli di misurazione. Se gli aggiornamenti si sovrappongono alla chiamata, il valore restituito non è necessariamente l’ultimo totale prima dell’azzeramento.

Esempi

import java.util.concurrent.atomic.LongAdder;

public class Main {
    public static void main(String[] args) {
        LongAdder requests = new LongAdder();
        LongAdder bytes = new LongAdder();

        for (long size : new long[] {512L, 1024L, 2048L, 3072L, 376L}) {
            requests.increment();
            bytes.add(size);
        }

        System.out.println("Requests: " + requests.sum());
        System.out.println("Bytes: " + bytes.sum());
        System.out.println("Bytes returned by sumThenReset(): " + bytes.sumThenReset());
        System.out.println("Bytes after sumThenReset(): " + bytes.sum());

        requests.reset();
        System.out.println("Requests after reset(): " + requests.sum());
    }
}

Risultato

Requests: 5
Bytes: 7032
Bytes returned by sumThenReset(): 7032
Bytes after sumThenReset(): 0
Requests after reset(): 0

Un solo thread conta cinque richieste e un totale di 7032 byte. `sumThenReset()` restituisce 7032 e azzera il contatore dei byte; `reset()` azzera il contatore delle richieste senza restituirne il valore precedente.

Lezioni correlate

  • Java · Lezione 31 · Avanzato · Versione: 2

Fonti