Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

EnumSet: adicionar, verificar e remover permissões

Em Java SE 21, `add`, `contains` e `remove` gerem um mesmo conjunto de permissões. A iteração segue a ordem de declaração das constantes, não a ordem de inserção.

Versão: Java SE 21

Sintaxe

java.util.EnumSet<E>, where E extends Enum<E>
boolean add(E e)
boolean contains(Object o)
boolean remove(Object o)

java.util.EnumSet<E> é um conjunto modificável de constantes de um único tipo enumerado. EnumSet.noneOf(Permission.class) cria um conjunto vazio para as constantes de Permission. add e remove alteram esse mesmo conjunto em vez de criarem outro. Só devolvem true quando o conteúdo muda.

add(E e) insere uma constante que ainda não está no conjunto. Adicioná-la novamente devolve false e não cria duplicados. contains(Object o) devolve true se o elemento estiver presente, sem alterar o conjunto. remove(Object o) remove um elemento presente e devolve false se este já estiver ausente.

add recebe um elemento do tipo E, enquanto contains e remove recebem um Object. Isso não converte uma cadeia de caracteres numa constante da enumeração: "WRITE" não corresponde a Permission.WRITE. add(null) lança NullPointerException; contains(null) e remove(null) devolvem false.

O iterador percorre apenas as constantes presentes, pela ordem em que foram declaradas na enumeração. Se READ tiver sido declarada antes de WRITE, o ciclo percorre primeiro READ, mesmo que WRITE tenha sido adicionada primeiro.

Exemplos

import java.util.EnumSet;

public class EnumSetPermissions {
    enum Permission { READ, WRITE }

    public static void main(String[] args) {
        EnumSet<Permission> permissions = EnumSet.noneOf(Permission.class);

        System.out.println("add WRITE: " + permissions.add(Permission.WRITE));
        System.out.println("add READ: " + permissions.add(Permission.READ));
        System.out.println("add WRITE again: " + permissions.add(Permission.WRITE));
        System.out.println("contains WRITE: " + permissions.contains(Permission.WRITE));

        for (Permission permission : permissions) {
            System.out.println("iterate: " + permission.name());
        }

        System.out.println("remove WRITE: " + permissions.remove(Permission.WRITE));
        System.out.println("remove WRITE again: " + permissions.remove(Permission.WRITE));
        System.out.println("contains WRITE: " + permissions.contains(Permission.WRITE));
    }
}

Resultado

add WRITE: true
add READ: true
add WRITE again: false
contains WRITE: true
iterate: READ
iterate: WRITE
remove WRITE: true
remove WRITE again: false
contains WRITE: false

`WRITE` é adicionada primeiro, mas o ciclo imprime `READ` antes de `WRITE`. A primeira remoção de `WRITE` devolve `true`, a segunda devolve `false` e a verificação final de pertença também devolve `false`.

Lições relacionadas

  • Java · Lição 19 · Avançado · Versão: 2

Fontes