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

CKTIS / Java

EnumMap — um mapa com chaves enum

EnumMap armazena chaves de um único tipo enum. O exemplo demonstra a criação, a inserção e a consulta de elementos, o tamanho e a iteração pela ordem de declaração das constantes enum.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

EnumMap<K, V> map = new EnumMap<>(K.class);
map.put(key, value);
map.get(key);
map.size();
map.entrySet();

java.util.EnumMap é um mapa cujas chaves pertencem a um único tipo enum. O construtor EnumMap(Class) cria um mapa vazio; passe, por exemplo, Status.class.

O fluxo EnumMap(Class)/put/get/size abrange a criação e o acesso básico. EnumMap.put armazena um valor, substitui o anterior e devolve esse valor anterior. EnumMap.get devolve o valor ou null; utilize containsKey para distinguir uma chave em falta de um valor null armazenado. size() conta associações, não constantes enum.

EnumMap.entrySet disponibiliza uma vista das entradas associada ao mapa. A iteração segue a ordem de declaração das constantes enum, e não a ordem de inserção.

Inserir uma chave null provoca NullPointerException; os valores null são permitidos. O mapa não é sincronizado: o acesso concorrente que envolva modificações requer sincronização externa.

Exemplos

import java.util.EnumMap;

public class Main {
    enum Status { NEW, DONE }

    public static void main(String[] args) {
        EnumMap<Status, Integer> counts = new EnumMap<>(Status.class);
        counts.put(Status.DONE, 2);
        counts.put(Status.NEW, 1);
        counts.put(Status.NEW, 3);

        System.out.println(counts.get(Status.NEW));
        System.out.println(counts.size());
        for (var entry : counts.entrySet()) {
            System.out.println(entry.getKey() + "=" + entry.getValue());
        }
    }
}

Resultado

3
2
NEW=3
DONE=2

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes