CKTIS / Java
LongAdder: atualizar, ler e repor a zero
Usa `LongAdder` para recolher estatísticas atualizadas por várias threads. Aprende quando a leitura é exata e por que razão `sumThenReset()` não separa de forma atómica os intervalos de medição.
Versão: Java SE 21
Sintaxe
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 mantém um total do tipo long que começa a zero. Quando há muita contenção entre threads, pode distribuir as atualizações por várias variáveis internas. É útil para recolher estatísticas, não para coordenar threads.
increment() adiciona 1, tal como add(1L). add(long x) adiciona o valor indicado, que pode ser negativo. Ambos os métodos têm tipo de retorno void. sum() devolve o total como long sem o alterar. Sem atualizações concorrentes, o resultado é exato. Caso contrário, a leitura não é um retrato atómico do estado e pode deixar de fora algumas dessas atualizações.
reset() repõe a mesma instância a zero e não devolve qualquer valor. Usa este método apenas quando souberes que nenhuma thread atualizará o contador durante a chamada. Sem atualizações concorrentes, sumThenReset() tem o mesmo efeito que chamar sum() e depois reset(): devolve o total anterior como long e repõe o contador a zero. O método não estabelece uma fronteira atómica entre intervalos de medição. Se houver atualizações durante a chamada, não há garantia de que o valor devolvido seja o último total antes da reposição a zero.
Exemplos
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());
}
}Resultado
Requests: 5 Bytes: 7032 Bytes returned by sumThenReset(): 7032 Bytes after sumThenReset(): 0 Requests after reset(): 0
Uma só thread conta cinco pedidos e um total de 7032 bytes. `sumThenReset()` devolve 7032 e repõe o contador de bytes a zero; `reset()` repõe o contador de pedidos a zero sem devolver o valor anterior.
Lições relacionadas
- Java · Lição 31 · Avançado · Versão: 2