CKTIS / Java
AtomicReference: actualizar una referencia de forma atómica
AtomicReference<V> ofrece operaciones atómicas sobre una referencia. Aprende en qué se diferencian get(), la sustitución condicional con compareAndSet() y la sustitución incondicional con getAndSet(), y por qué el éxito de una sustitución condicional depende de la identidad del objeto, no de la igualdad de su contenido.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
AtomicReference<V> ref = new AtomicReference<>(initialValue);
V current = ref.get();
boolean changed = ref.compareAndSet(expectedValue, newValue);
V previous = ref.getAndSet(newValue);AtomicReference<V> del paquete java.util.concurrent.atomic almacena una referencia que se puede actualizar de forma atómica. Protege las operaciones sobre la referencia, no los campos del objeto referenciado; no hace que ese objeto sea seguro para hilos automáticamente.
AtomicReference.get() lee la referencia con la semántica de lectura volatile. AtomicReference.compareAndSet(expectedValue, newValue) compara y sustituye de forma atómica: usa ==, no equals(). Devuelve true si se realiza la sustitución o false si no hay coincidencia, sin cambiar el valor.
AtomicReference.getAndSet(newValue) sustituye la referencia de forma atómica e incondicional y devuelve la referencia anterior. Las llamadas separadas a get() y a la escritura no forman una única operación atómica; otro hilo puede actuar entre ambas.
El ejemplo usa un solo hilo para que la salida sea determinista. Dos objetos new String("ready") tienen el mismo contenido, pero identidades distintas: la primera comparación falla, mientras que la segunda usa la referencia almacenada y tiene éxito. Alcance de la documentación: Java SE 21; no se han acreditado el entorno de ejecución del repositorio ni el de producción.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.