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 nullAs 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