Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

EnumMap: costruttore con Class, put, get ed entrySet

Crea una mappa delle transizioni per un solo tipo enum, scrivi e leggi le associazioni e scorri le voci in ordine di dichiarazione. Distingui una transizione assente da un valore null memorizzato.

Versione: Java SE 21

Sintassi

java.util.EnumMap<K, V>  // K extends Enum<K>

EnumMap(Class<K> keyType)
V put(K key, V value)
V get(Object key)
Set<Map.Entry<K, V>> entrySet()
boolean containsKey(Object key)  // distinguishes absence from a stored null

Le chiavi di una java.util.EnumMap<K, V> appartengono tutte allo stesso tipo enumerato K. Il costruttore EnumMap(Class<K> keyType) riceve un oggetto di classe come State.class per identificare il tipo delle chiavi a tempo di esecuzione. La mappa nasce vuota: per le costanti non vengono create voci automaticamente.

put(K key, V value) aggiunge o sostituisce un’associazione e restituisce il valore precedente, oppure null se la chiave era assente o associata a null. I valori null sono ammessi, ma inserire una chiave null genera una NullPointerException.

get(Object key) restituisce il valore associato, oppure null se la chiave della transizione è assente. Un valore null memorizzato dà lo stesso risultato. Se devi distinguere i due casi, usa containsKey(key): true indica che l’associazione esiste.

entrySet() restituisce un Set<Map.Entry<K, V>> che è una vista della mappa, non una copia. L’iterazione segue l’ordine di dichiarazione delle costanti usate come chiavi, non quello di inserimento. Rimuovere una voce tramite la vista elimina anche la relativa associazione dalla mappa.

Esempi

import java.util.EnumMap;
import java.util.Map;

public class Main {
    enum State { NEW, RUNNING, DONE }

    public static void main(String[] args) {
        EnumMap<State, State> next = new EnumMap<>(State.class);
        next.put(State.RUNNING, State.DONE);
        next.put(State.NEW, State.RUNNING);

        System.out.println("Next from NEW: " + next.get(State.NEW));
        System.out.println("Next from DONE: " + next.get(State.DONE));

        for (Map.Entry<State, State> entry : next.entrySet()) {
            System.out.println(entry.getKey() + " -> " + entry.getValue());
        }
    }
}

Risultato

Next from NEW: RUNNING
Next from DONE: null
NEW -> RUNNING
RUNNING -> DONE

`RUNNING` viene inserito prima di `NEW`, ma il ciclo stampa prima `NEW` per via dell’ordine di dichiarazione. Non c’è alcuna transizione per `DONE`, quindi `get(State.DONE)` restituisce `null`.

Lezioni correlate

  • Java · Lezione 19 · Avanzato · Versione: 2

Fonti