Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

EnumSet.of — crear un conjunto de constantes de un enum

Crea un conjunto modificable e inicialmente no vacío con constantes de un mismo tipo enum. Distingue las características de un colector de la máscara de bits de un spliterator.

Versión: Java SE 21

Sintaxis

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 es un método de fábrica estático de java.util.EnumSet. Devuelve un nuevo EnumSet<E> modificable e inicialmente no vacío. Todas las constantes deben pertenecer al mismo tipo enum E; en código con seguridad de tipos, mezclar distintos tipos enum provoca un error de compilación. Una constante repetida solo aparece una vez. La iteración sigue el orden de declaración, no el de los argumentos.

Hay cinco sobrecargas con un número fijo de argumentos, de uno a cinco. of(E first, E... rest) exige una primera constante y acepta el resto como argumentos adicionales o como un array. No existe of() sin argumentos; usa EnumSet.noneOf(Access.class) para empezar con un conjunto vacío. Una constante null o un array rest que sea null provoca una NullPointerException.

Con tres argumentos, EnumSet.of puede agrupar tres valores de Collector.Characteristics: CONCURRENT permite a varios hilos invocar el acumulador sobre el mismo contenedor, UNORDERED no garantiza que se preserve el orden de aparición de los elementos de entrada e IDENTITY_FINISH indica que la función de finalización es la identidad. El conjunto por sí solo no configura un colector. Si implementas Collector.characteristics(), devuelve un conjunto no modificable en vez del EnumSet modificable directamente. En cambio, Spliterator.characteristics() devuelve una máscara de bits de tipo int sobre el spliterator y sus elementos, no un conjunto de valores del enum del colector.

Ejemplos

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]

Las dos primeras llamadas usan las sobrecargas de uno y dos argumentos. La segunda pasa `WRITE` antes de `READ`, pero la salida sigue el orden de declaración. La última llamada solo crea un conjunto de características, no un colector ni un spliterator.

Lecciones relacionadas

  • Java · Lección 19 · Avanzado · Versión: 2
  • Java · Lección 24 · Avanzado · Versión: 2

Fuentes