Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

AtomicReference — aggiornare un riferimento in modo atomico

AtomicReference<V> offre operazioni atomiche su un singolo riferimento. Scopri le differenze tra get(), la sostituzione condizionale con compareAndSet() e quella incondizionata con getAndSet(), e perché il successo di una sostituzione condizionale dipende dall’identità dell’oggetto, non dall’uguaglianza del suo contenuto.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

AtomicReference<V> del pacchetto java.util.concurrent.atomic contiene un singolo riferimento aggiornabile in modo atomico. Protegge le operazioni sul riferimento, non i campi dell’oggetto referenziato; non rende automaticamente quell’oggetto thread-safe.

AtomicReference.get() legge il riferimento con la semantica di lettura volatile. AtomicReference.compareAndSet(expectedValue, newValue) confronta e sostituisce in modo atomico: usa ==, non equals(). Restituisce true dopo la sostituzione oppure false in caso di mancata corrispondenza, senza modificare il valore.

AtomicReference.getAndSet(newValue) sostituisce il riferimento in modo atomico e incondizionato e restituisce quello precedente. Chiamate separate a get() e alla scrittura non costituiscono un’unica operazione atomica; nel frattempo può intervenire un altro thread.

L’esempio usa un solo thread per ottenere un risultato deterministico. Due oggetti new String("ready") hanno lo stesso contenuto ma identità diverse: il primo confronto fallisce, mentre il secondo usa il riferimento memorizzato e riesce. Ambito della documentazione: Java SE 21; l’ambiente di esecuzione del repository e quello di produzione non sono attestati.

Esempi

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());
    }
}

Risultato

ready
false
true
running
done

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti