CKTIS / Java
ConcurrentHashMap: get, put y merge atómico
Usa `get` para leer, `put` para escribir sin condiciones y `merge` para actualizar una sola clave de forma atómica, por ejemplo en un contador compartido entre hilos.
Versión: Java SE 21
Sintaxis
import java.util.concurrent.ConcurrentHashMap;
import java.util.function.BiFunction;
// Instance methods of ConcurrentHashMap<K, V>
public V get(Object key)
public V put(K key, V value)
public V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)En Java SE 21, ConcurrentHashMap.get (get(Object key)) lee un valor sin modificar el mapa y devuelve null si la clave no existe. ConcurrentHashMap.put inserta o sustituye un valor y devuelve el valor anterior, o null si no había ninguna entrada.
Si la clave no existe, ConcurrentHashMap.merge inserta el valor proporcionado sin llamar a la función. Si la clave existe, llama a la función con el valor existente como primer argumento y el valor proporcionado como segundo. Guarda y devuelve el resultado o, si la función devuelve null, elimina la entrada y devuelve null.
El mapa no admite claves ni valores null. Una clave null en cualquiera de estos métodos, un valor null pasado a put o merge o una función null pasada a merge provoca NullPointerException. Si la función lanza una RuntimeException o un Error, merge lo propaga sin cambiar la entrada. Mantén la función breve: algunas actualizaciones pueden tener que esperar a que termine. La función no debe modificar este mapa durante el cálculo. Si merge detecta un intento de actualización recursiva de este mapa que, de otro modo, nunca terminaría, lanza IllegalStateException.
Una llamada a merge lee y actualiza la entrada de una clave de forma atómica. Las llamadas separadas a get y put pueden perder un incremento si dos hilos leen el mismo valor y escriben el mismo resultado. Esta garantía es de ConcurrentHashMap, no de la implementación predeterminada de Map.merge, y no proporciona una transacción para varias claves.
Ejemplos
import java.util.concurrent.ConcurrentHashMap;
public class Main {
public static void main(String[] args) throws InterruptedException {
var counts = new ConcurrentHashMap<String, Integer>();
String key = "hits";
System.out.println(counts.get(key));
System.out.println(counts.merge(key, 1, Integer::sum));
System.out.println(counts.put(key, 10));
Runnable increment = () -> {
for (int i = 0; i < 1_000; i++) {
counts.merge(key, 1, Integer::sum);
}
};
Thread first = new Thread(increment);
Thread second = new Thread(increment);
first.start();
second.start();
first.join();
second.join();
System.out.println(counts.get(key));
System.out.println(counts.merge(key, 1, (oldValue, addedValue) -> null));
System.out.println(counts.get(key));
}
}Resultado
null 1 1 2010 null null
La primera lectura devuelve `null`. El primer `merge` inserta y devuelve `1`, y `put` guarda `10` y devuelve el `1` anterior. Cada hilo suma 1000; `join()` espera a que ambos terminen antes de leer `2010`. El último `merge` elimina la entrada, por lo que tanto esa llamada como la siguiente lectura devuelven `null`.
Lecciones relacionadas
- Java · Lección 56 · Intermedio · Versión: 2