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(); // voidjava.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.