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.