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

CKTIS / Java

AtomicReference — atualizar uma referência de forma atómica

AtomicReference<V> disponibiliza operações atómicas sobre uma única referência. Saiba em que diferem get(), a substituição condicional com compareAndSet() e a substituição incondicional com getAndSet(), e por que motivo o sucesso de uma substituição condicional depende da identidade do objeto, e não da igualdade do seu conteúdo.

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

Sintaxe

AtomicReference<V> ref = new AtomicReference<>(initialValue);
V current = ref.get();
boolean changed = ref.compareAndSet(expectedValue, newValue);
V previous = ref.getAndSet(newValue);

AtomicReference<V> do pacote java.util.concurrent.atomic guarda uma única referência que pode ser atualizada de forma atómica. Protege as operações sobre a referência, não os campos do objeto referenciado; não torna automaticamente esse objeto seguro para utilização concorrente.

AtomicReference.get() lê a referência com a semântica de leitura volatile. AtomicReference.compareAndSet(expectedValue, newValue) compara e substitui de forma atómica: usa ==, não equals(). Devolve true após a substituição ou false se não houver correspondência, sem alterar o valor.

AtomicReference.getAndSet(newValue) substitui a referência de forma atómica e incondicional e devolve a referência anterior. Chamadas separadas a get() e à escrita não constituem uma única operação atómica; outra thread pode atuar entre ambas.

O exemplo usa uma única thread para obter um resultado determinístico. Dois objetos new String("ready") têm o mesmo conteúdo, mas identidades diferentes: a primeira comparação falha, enquanto a segunda usa a referência guardada e é bem-sucedida. Âmbito da documentação: Java SE 21; os ambientes de execução do repositório e de produção não foram confirmados.

Exemplos

import java.util.concurrent.atomic.AtomicReference;

public class Main {
    public static void main(String[] args) {
        String initial = new String("ready");
        AtomicReference<String> ref = new AtomicReference<>(initial);

        System.out.println(ref.get());
        System.out.println(ref.compareAndSet(new String("ready"), "wrong"));
        System.out.println(ref.compareAndSet(initial, "running"));
        System.out.println(ref.getAndSet("done"));
        System.out.println(ref.get());
    }
}

Resultado

ready
false
true
running
done

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