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

CKTIS / Java

AtomicInteger — operações atómicas sobre int

AtomicInteger disponibiliza operações atómicas sobre um único valor int partilhado entre threads. Aprende a ler, escrever, incrementar e atualizar de forma condicional, incluindo os limites da atomicidade.

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

Sintaxe

import java.util.concurrent.atomic.AtomicInteger;
AtomicInteger counter = new AtomicInteger(0);
int updated = counter.incrementAndGet();
int current = counter.get();
counter.set(10);
boolean changed = counter.compareAndSet(10, 20);

java.util.concurrent.atomic.AtomicInteger contém um único valor int mutável, como um contador partilhado entre threads. Não é um substituto de uso geral para Integer. Âmbito desta entrada: Java SE 21; nem o ambiente de execução do repositório nem o de produção está certificado.

AtomicInteger.incrementAndGet() incrementa atomicamente o valor em uma unidade e devolve o novo valor. AtomicInteger.get() lê o valor atual, enquanto AtomicInteger.set(newValue) o escreve e devolve void. A leitura e a escrita têm semântica de memória volatile.

AtomicInteger.compareAndSet(expectedValue, newValue) compara atomicamente o valor atual com expectedValue usando ==. Se forem iguais, escreve newValue e devolve true; caso contrário, mantém o valor inalterado e devolve false.

A atomicidade das operações individuais não torna atómicas sequências completas: counter.set(counter.get() + 1) pode perder a atualização de outra thread. Para incrementar, usa counter.incrementAndGet(). Um único objeto também não garante a atomicidade de alterações em várias variáveis independentes.

Exemplos

import java.util.concurrent.atomic.AtomicInteger;

public class Main {
    public static void main(String[] args) {
        AtomicInteger counter = new AtomicInteger(0);
        System.out.println(counter.incrementAndGet());
        System.out.println(counter.get());
        counter.set(10);
        System.out.println(counter.compareAndSet(10, 20));
        System.out.println(counter.compareAndSet(10, 30));
        System.out.println(counter.get());
    }
}

Resultado

1
1
true
false
20

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