Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

java.util.Map — asociación de claves y valores

Map<K,V> asocia cada clave con un máximo de un valor. Aprende a consultar y actualizar datos, calcular valores y usar vistas del mapa, prestando especial atención al tratamiento de null y a las garantías de la implementación.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

Map<K, V> map = new HashMap<>();

java.util.Map<K,V> es una interfaz que asocia claves con valores; los valores pueden repetirse. HashMap no garantiza ningún orden, mientras que TreeMap ordena las claves. La compatibilidad con null depende de la implementación. No modifiques una clave almacenada de una forma que afecte a su comparación.

Map.put(k, v) añade o sustituye un valor y devuelve el anterior; Map.remove(k) elimina una entrada y devuelve su valor anterior. Ambos también devuelven null si la entrada no existe. Map.get(k) devuelve el valor o null; Map.containsKey(k) distingue entre una entrada inexistente y una asociada a null. Map.getOrDefault(k, d) devuelve d solo si la entrada no existe, no cuando tiene asociado null. Map.size() cuenta las entradas; Map.containsValue(v) comprueba si aparece un valor.

Map.compute(k, f) pasa a la función la clave y el valor actual, o null; un resultado null elimina la entrada o hace que siga sin existir. Map.computeIfAbsent(k, f) llama a la función si la entrada no existe o su valor es null; solo guarda un resultado no nulo. Map.merge(k, v, f) requiere v != null: si la entrada no existe o su valor es null, guarda v; en caso contrario, combina el valor anterior con v. Un resultado null elimina la entrada.

Map.keySet() expone un conjunto de claves, Map.values() una colección de valores y Map.entrySet() un conjunto de pares Map.Entry<K,V>. Son vistas respaldadas por el mapa, no copias; eliminar mediante una vista elimina la entrada cuando la operación está admitida. Map.forEach(action) recorre cada par.

Las operaciones que modifican el mapa pueden lanzar UnsupportedOperationException. Las funciones de cálculo no deberían modificar el mismo mapa. Los métodos predeterminados de Map no garantizan ni atomicidad ni sincronización. El ejemplo usa TreeMap para que el orden de salida sea determinista.

Ejemplos

import java.util.Map;
import java.util.TreeMap;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counts = new TreeMap<>();
        counts.put("pear", 1);
        counts.merge("pear", 2, Integer::sum);
        counts.computeIfAbsent("apple", key -> 1);
        counts.compute("apple", (key, value) -> value + 1);
        System.out.println(counts.get("pear"));
        System.out.println(counts.getOrDefault("plum", 0));
        System.out.println(counts.containsKey("plum"));
        System.out.println(counts.containsValue(2));
        System.out.println(counts.size());
        System.out.println(counts.keySet());
        System.out.println(counts.values());
        System.out.println(counts.entrySet());
        counts.forEach((key, value) -> System.out.println(key + ":" + value));
        System.out.println(counts.remove("pear"));
        System.out.println(counts.size());
    }
}

Resultado

3
0
false
true
2
[apple, pear]
[2, 3]
[apple=2, pear=3]
apple:2
pear:3
3
1

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.

Fuentes