WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

EnumMap — eine Map mit Enum-Schlüsseln

EnumMap speichert Schlüssel eines einzelnen Enum-Typs. Das Beispiel zeigt die Erstellung, das Einfügen und Abrufen von Einträgen, die Größe sowie die Iteration in der Deklarationsreihenfolge der Enum-Konstanten.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

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

java.util.EnumMap ist eine Map, deren Schlüssel zu einem einzelnen enum-Typ gehören. Der Konstruktor EnumMap(Class) erstellt eine leere Map; übergib beispielsweise Status.class.

Der Ablauf EnumMap(Class)/put/get/size umfasst die Erstellung und den grundlegenden Zugriff. EnumMap.put speichert einen Wert, ersetzt dabei den vorherigen und gibt diesen zurück. EnumMap.get gibt den Wert oder null zurück; mit containsKey lässt sich unterscheiden, ob ein Eintrag fehlt oder ein gespeichertes null vorliegt. size() zählt Einträge, nicht Enum-Konstanten.

EnumMap.entrySet stellt eine an die Map gebundene Ansicht der Einträge bereit. Die Iteration folgt der Deklarationsreihenfolge der Enum-Konstanten, nicht der Einfügereihenfolge.

Beim Einfügen eines null-Schlüssels wird NullPointerException ausgelöst; null-Werte sind zulässig. Die Map ist nicht synchronisiert: Bei gleichzeitigem Zugriff mit Änderungen ist eine externe Synchronisierung erforderlich.

Beispiele

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

Ergebnis

3
2
NEW=3
DONE=2

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen