Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

EnumMap: construtor com Class, put, get e entrySet

Cria um mapa de transições para um único tipo enum, escreve e lê associações e percorre as entradas pela ordem de declaração. Distingue uma transição em falta de um valor null guardado.

Versão: Java SE 21

Sintaxe

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

As chaves de um java.util.EnumMap<K, V> pertencem todas ao mesmo tipo enumerado K. O construtor EnumMap(Class<K> keyType) recebe um objeto de classe como State.class para identificar o tipo das chaves em tempo de execução. O mapa começa vazio: não são criadas entradas automaticamente para as constantes.

put(K key, V value) adiciona ou substitui uma associação e devolve o valor anterior, ou null se a chave não existia ou estava associada a null. São permitidos valores null, mas inserir uma chave null lança uma NullPointerException.

get(Object key) devolve o valor associado, ou null se a chave de transição estiver em falta. Um valor null guardado dá o mesmo resultado. Se precisares de distinguir os casos, usa containsKey(key): true indica que a associação existe.

entrySet() devolve um Set<Map.Entry<K, V>> que é uma vista do mapa, não uma cópia. A iteração segue a ordem de declaração das constantes usadas como chaves, não a ordem de inserção. Remover uma entrada através da vista também remove a respetiva associação do mapa.

Exemplos

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

Resultado

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

`RUNNING` é inserido antes de `NEW`, mas o ciclo imprime primeiro `NEW` devido à ordem de declaração. Não há uma transição guardada para `DONE`, por isso `get(State.DONE)` devolve `null`.

Lições relacionadas

  • Java · Lição 19 · Avançado · Versão: 2

Fontes