CKTIS / Java
EnumSet.of — criar um conjunto de constantes de um enum
Cria um conjunto modificável e inicialmente não vazio com constantes do mesmo tipo enum. Distingue as características de um coletor da máscara de bits de um spliterator.
Versão: Java SE 21
Sintaxe
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 é um método de fábrica estático de java.util.EnumSet. Devolve um novo EnumSet<E> modificável e inicialmente não vazio. Todas as constantes têm de pertencer ao mesmo tipo enum E; em código com segurança de tipos, misturar tipos enum diferentes dá erro de compilação. Uma constante repetida aparece apenas uma vez. A iteração segue a ordem de declaração, não a dos argumentos.
Há cinco sobrecargas com um número fixo de argumentos, de um a cinco. of(E first, E... rest) exige uma primeira constante e aceita as restantes como argumentos adicionais ou como um array. Não existe of() sem argumentos; usa EnumSet.noneOf(Access.class) para começar com um conjunto vazio. Uma constante null ou um array rest com valor null provoca uma NullPointerException.
Com três argumentos, EnumSet.of pode agrupar três valores de Collector.Characteristics: CONCURRENT permite que várias threads chamem o acumulador sobre o mesmo contentor, UNORDERED não garante que se preserve a ordem pela qual os elementos de entrada são encontrados e IDENTITY_FINISH indica que a função de finalização é a função identidade. O conjunto, por si só, não configura um coletor. Se implementares Collector.characteristics(), devolve um conjunto não modificável em vez de devolver diretamente o EnumSet modificável. Já Spliterator.characteristics() devolve uma máscara de bits do tipo int que descreve o spliterator e os seus elementos, não um conjunto de valores enum do coletor.
Exemplos
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);
}
}Resultado
[READ] [READ, WRITE] [CONCURRENT, UNORDERED, IDENTITY_FINISH]
As primeiras duas chamadas usam as sobrecargas com um e dois argumentos. A segunda passa `WRITE` antes de `READ`, mas a saída segue a ordem de declaração. A última chamada cria apenas um conjunto de características, não um coletor nem um spliterator.
Lições relacionadas
- Java · Lição 19 · Avançado · Versão: 2
- Java · Lição 24 · Avançado · Versão: 2