WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

EnumSet.of — eine Menge ausgewählter Enum-Konstanten erstellen

Erstelle eine anfangs nicht leere, veränderbare Menge von Konstanten eines Enum-Typs. Unterscheide Collector-Merkmale von der Bitmaske eines Spliterators.

Version: Java SE 21

Syntax

public static <E extends Enum<E>> EnumSet<E> of(E e)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4, E e5)
@SafeVarargs
public static <E extends Enum<E>> EnumSet<E> of(E first, E... rest)

EnumSet.of ist eine statische Fabrikmethode von java.util.EnumSet. Sie liefert ein neues, veränderbares EnumSet<E>, das anfangs nicht leer ist. Alle Konstanten müssen zum selben Enum-Typ E gehören; in typsicherem Code führt das Mischen verschiedener Enum-Typen zu einem Kompilierfehler. Wiederholte Konstanten erscheinen nur einmal. Die Iteration folgt der Deklarationsreihenfolge, nicht der Argumentreihenfolge.

Es gibt fünf Überladungen mit fester Argumentzahl, für ein bis fünf Argumente. of(E first, E... rest) verlangt eine erste Konstante und nimmt die übrigen als weitere Argumente oder als Array entgegen. Ein of() ohne Argumente gibt es nicht; für eine leere Menge verwende EnumSet.noneOf(Access.class). Eine Konstante mit dem Wert null oder ein rest-Array mit dem Wert null löst eine NullPointerException aus.

Mit drei Argumenten kann EnumSet.of drei Werte von Collector.Characteristics zusammenfassen: CONCURRENT erlaubt mehreren Threads, die Akkumulatorfunktion für denselben Container aufzurufen; UNORDERED verspricht nicht, die Reihenfolge der Eingabeelemente beizubehalten; IDENTITY_FINISH bedeutet, dass die Abschlussfunktion die Identitätsfunktion ist. Die Menge allein konfiguriert keinen Collector. Wenn du Collector.characteristics() implementierst, gib eine nicht veränderbare Menge zurück, nicht direkt das veränderbare EnumSet. Spliterator.characteristics() dagegen liefert eine int-Bitmaske für Merkmale des Spliterators und seiner Elemente, keine Menge von Collector-Enum-Werten.

Beispiele

import java.util.EnumSet;
import java.util.stream.Collector.Characteristics;

public class Main {
    enum Access { READ, WRITE }

    public static void main(String[] args) {
        EnumSet<Access> readOnly = EnumSet.of(Access.READ);
        EnumSet<Access> readWrite = EnumSet.of(Access.WRITE, Access.READ);
        EnumSet<Characteristics> characteristics = EnumSet.of(
                Characteristics.UNORDERED,
                Characteristics.CONCURRENT,
                Characteristics.IDENTITY_FINISH);

        System.out.println(readOnly);
        System.out.println(readWrite);
        System.out.println(characteristics);
    }
}

Ergebnis

[READ]
[READ, WRITE]
[CONCURRENT, UNORDERED, IDENTITY_FINISH]

Die ersten beiden Aufrufe verwenden die Überladungen mit einem bzw. zwei Argumenten. Im zweiten steht `WRITE` vor `READ`, doch die Ausgabe folgt der Deklarationsreihenfolge. Der letzte Aufruf erstellt nur eine Merkmalsmenge, keinen Collector oder Spliterator.

Zugehörige Lektionen

  • Java · Lektion 19 · Fortgeschritten · Version: 2
  • Java · Lektion 24 · Fortgeschritten · Version: 2

Quellen