Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

EnumSet.of — creare un insieme di costanti enum

Crea un insieme modificabile, inizialmente non vuoto, di costanti dello stesso tipo enum. Distingui le caratteristiche di un collector dalla maschera di bit di uno spliterator.

Versione: Java SE 21

Sintassi

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 è un metodo factory statico di java.util.EnumSet. Restituisce un nuovo EnumSet<E> modificabile e inizialmente non vuoto. Tutte le costanti devono appartenere allo stesso tipo enum E; nel codice con controllo dei tipi, mescolare tipi enum diversi causa un errore di compilazione. Una costante ripetuta compare una sola volta. L’iterazione segue l’ordine di dichiarazione, non quello degli argomenti.

Ci sono cinque overload con un numero fisso di argomenti, da uno a cinque. of(E first, E... rest) richiede una prima costante e accetta le restanti come argomenti aggiuntivi o come array. Non esiste of() senza argomenti; per partire da un insieme vuoto usa EnumSet.noneOf(Access.class). Una costante null o un array rest pari a null causa una NullPointerException.

Con tre argomenti, EnumSet.of può raggruppare tre valori di Collector.Characteristics: CONCURRENT consente a più thread di chiamare l’accumulatore sullo stesso contenitore, UNORDERED non garantisce di conservare l’ordine in cui si incontrano gli elementi in ingresso e IDENTITY_FINISH indica che la funzione di finitura è la funzione identità. L’insieme da solo non configura un collector. Se implementi Collector.characteristics(), restituisci un insieme non modificabile invece di restituire direttamente l’EnumSet modificabile. Spliterator.characteristics(), invece, restituisce una maschera di bit di tipo int che descrive lo spliterator e i suoi elementi, non un insieme di valori enum del collector.

Esempi

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

Risultato

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

Le prime due chiamate usano gli overload con uno e due argomenti. La seconda passa `WRITE` prima di `READ`, ma l’output segue l’ordine di dichiarazione. L’ultima chiamata crea solo un insieme di caratteristiche, non un collector né uno spliterator.

Lezioni correlate

  • Java · Lezione 19 · Avanzato · Versione: 2
  • Java · Lezione 24 · Avanzato · Versione: 2

Fonti