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

CKTIS / Java

AtomicLong — um contador long atómico

AtomicLong contém um único valor long e disponibiliza atualizações atómicas partilhadas entre threads. O método incrementAndGet() aumenta o valor em um e devolve o resultado atualizado.

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

Sintaxe

AtomicLong counter = new AtomicLong(0L);
long updated = counter.incrementAndGet();

java.util.concurrent.atomic.AtomicLong é um objeto mutável que contém um único valor do tipo long. É adequado para contadores partilhados e números de sequência. O construtor new AtomicLong() define inicialmente o valor como zero; new AtomicLong(0L) indica esse valor explicitamente. Não substitui um objeto Long imutável.

AtomicLong.incrementAndGet() executa a leitura, o incremento em um e a escrita como uma única operação atómica e, em seguida, devolve o valor long atualizado. Em contrapartida, getAndIncrement() devolve o valor anterior ao incremento. get() lê o valor atual.

A atomicidade de um método individual não abrange uma sequência arbitrária de chamadas: counter.set(counter.get() + 1) não é um incremento atómico. Outra thread pode alterar o contador entre a leitura e a escrita. Para essa atualização, utilize counter.incrementAndGet(); o contador, por si só, também não protege invariantes que envolvam várias variáveis.

No exemplo, duas threads incrementam o mesmo contador 1000 vezes cada. Ambas as chamadas a join() ocorrem antes da leitura do resultado, pelo que a ordem de execução das threads não altera o resultado esperado 2000. Âmbito da documentação: Java SE 21; os ambientes de execução do repositório e de produção não estão atestados.

Exemplos

import java.util.concurrent.atomic.AtomicLong;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        AtomicLong counter = new AtomicLong(0L);
        Runnable work = () -> {
            for (int i = 0; i < 1000; i++) {
                counter.incrementAndGet();
            }
        };

        Thread first = new Thread(work);
        Thread second = new Thread(work);
        first.start();
        second.start();
        first.join();
        second.join();

        System.out.println(counter.get());
    }
}

Resultado

2000

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