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.