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