Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

EnumSet.of — zbiór wybranych stałych enum

Twórz początkowo niepusty, modyfikowalny zbiór stałych jednego typu wyliczeniowego. Odróżniaj cechy kolektora od maski bitowej spliteratora.

Wersja: Java SE 21

Składnia

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 to statyczna metoda fabrykująca klasy java.util.EnumSet. Zwraca nowy, modyfikowalny EnumSet<E>, który początkowo jest niepusty. Wszystkie stałe muszą należeć do tego samego typu wyliczeniowego E; w kodzie z kontrolą typów próba połączenia różnych typów enum nie przejdzie kompilacji. Powtórzenia dają jeden element, a iteracja przebiega w kolejności deklaracji stałych, nie w kolejności argumentów.

Istnieje pięć przeciążeń o stałej liczbie argumentów, od jednego do pięciu. Przeciążenie of(E first, E... rest) wymaga pierwszej stałej, a resztę przyjmuje jako kolejne argumenty lub tablicę. Nie ma of() bez argumentów: pusty zbiór utworzysz przez EnumSet.noneOf(Access.class). Stała o wartości null lub tablica rest o wartości null powoduje NullPointerException.

Trzyargumentowe EnumSet.of może zebrać trzy wartości Collector.Characteristics: CONCURRENT pozwala wielu wątkom wywoływać akumulator na tym samym kontenerze, UNORDERED oznacza brak gwarancji zachowania kolejności napotykania elementów wejściowych, a IDENTITY_FINISH oznacza, że funkcja kończąca jest funkcją tożsamościową. Sam zbiór nie konfiguruje kolektora. Jeśli implementujesz Collector.characteristics(), zwróć niemodyfikowalny zbiór, a nie bezpośrednio modyfikowalny EnumSet. Natomiast Spliterator.characteristics() zwraca maskę bitową typu int opisującą spliterator i jego elementy, nie zbiór wartości enum kolektora.

Przykłady

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

Wynik

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

Pierwsze dwa wywołania używają przeciążeń jedno- i dwuargumentowego. Choć w drugim `WRITE` podano przed `READ`, wydruk pokazuje kolejność deklaracji. Ostatnie wywołanie tworzy jedynie zbiór cech, bez kolektora i spliteratora.

Powiązane lekcje

  • Java · Lekcja 19 · Zaawansowany · Wersja: 2
  • Java · Lekcja 24 · Zaawansowany · Wersja: 2

Źródła