Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

LongAdder — contagem e soma concorrentes

LongAdder acumula uma soma do tipo long, atualizada por várias threads. É adequado para estatísticas, mas sum() não fornece uma captura atómica e, para o reiniciar, é necessário controlar as atualizações concorrentes.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

LongAdder counter = new LongAdder();
counter.increment();       // void
counter.add(longValue);    // void
long total = counter.sum();
long previous = counter.sumThenReset();
counter.reset();           // void

java.util.concurrent.atomic.LongAdder começa em zero e distribui as atualizações por variáveis internas para reduzir a contenção entre threads. Em situações de elevada contenção, pode oferecer um débito superior ao de AtomicLong, à custa de memória. Utilize-o para estatísticas, não para controlar com precisão a sincronização.

LongAdder.increment() adiciona um e LongAdder.add(long) adiciona o valor indicado; ambos os métodos devolvem void. LongAdder.sum() devolve um long, mas não fornece uma captura atómica: pode não incluir atualizações que ocorram durante a leitura. Sem atualizações concorrentes, o resultado é exato.

LongAdder.reset() repõe o estado a zero e devolve void; utilize este método apenas quando nenhuma thread estiver a atualizar o contador. LongAdder.sumThenReset() devolve a soma e repõe o estado a zero. Não o considere um limite atómico entre períodos de medição: com atualizações concorrentes, o resultado pode não corresponder ao valor final anterior à reposição.

No exemplo, ambas as chamadas a join() precedem as leituras e a reposição a zero. Assim, o resultado esperado é determinístico. A documentação abrange Java SE 21; o ambiente de execução do repositório não atesta o ambiente de produção.

Exemplos

import java.util.concurrent.atomic.LongAdder;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        LongAdder counter = new LongAdder();
        Runnable task = () -> {
            for (int i = 0; i < 1000; i++) {
                counter.increment();
            }
        };
        Thread first = new Thread(task);
        Thread second = new Thread(task);
        first.start();
        second.start();
        first.join();
        second.join();

        counter.add(5);
        System.out.println(counter.sum());
        System.out.println(counter.sumThenReset());
        System.out.println(counter.sum());
        counter.add(7);
        counter.reset();
        System.out.println(counter.sum());
    }
}

Resultado

2005
2005
0
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes