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

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

Fontes