База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

EnumSet.of — създаване на множество от enum константи

Създай изменяемо, първоначално непразно множество от константи на един изброим тип. Разграничи характеристиките на колектор от битовата маска на сплитератор.

Версия: Java SE 21

Синтаксис

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 е статичен фабричен метод на java.util.EnumSet. Той връща ново, изменяемо множество EnumSet<E>, което първоначално е непразно. Всички константи трябва да принадлежат на един и същ изброим тип E; в код с проверка на типовете смесването на различни изброими типове води до грешка при компилация. Повторената константа присъства само веднъж. Обхождането следва реда на деклариране, а не реда на аргументите.

Има пет претоварени варианта с фиксиран брой аргументи — от един до пет. of(E first, E... rest) изисква първа константа и приема останалите като допълнителни аргументи или масив. Няма of() без аргументи; за празно множество използвай EnumSet.noneOf(Access.class). Константа със стойност null или масив rest със стойност null предизвиква NullPointerException.

С три аргумента EnumSet.of може да обедини три стойности на Collector.Characteristics: CONCURRENT позволява на няколко нишки да извикват акумулатора върху един и същ контейнер, UNORDERED не гарантира запазване на реда, в който се срещат входните елементи, а IDENTITY_FINISH означава, че завършващата функция е тъждествена. Самото множество не конфигурира колектор. Ако реализираш Collector.characteristics(), върни множество, което не може да се променя, вместо директно да върнеш изменяемия EnumSet. За разлика от него Spliterator.characteristics() връща битова маска от тип int, описваща сплитератора и елементите му, а не множество от стойности на изброимия тип на колектора.

Примери

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

Резултат

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

Първите две извиквания използват вариантите с един и два аргумента. Второто подава `WRITE` преди `READ`, но изходът следва реда на деклариране. Последното извикване създава само множество от характеристики, а не колектор или сплитератор.

Свързани уроци

  • Java · Урок 19 · Напреднало · Версия: 2
  • Java · Урок 24 · Напреднало · Версия: 2

Източници