CKTIS / Java
EnumSet : ajouter, vérifier et retirer des permissions
En Java SE 21, `add`, `contains` et `remove` permettent de gérer un même ensemble de permissions. Le parcours suit l’ordre de déclaration des constantes, et non leur ordre d’ajout.
Version : Java SE 21
Syntaxe
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> est un ensemble modifiable de constantes d’un seul type énuméré. EnumSet.noneOf(Permission.class) crée un ensemble vide destiné aux constantes de type Permission. add et remove modifient ce même ensemble au lieu d’en créer un nouveau. Elles renvoient true uniquement si son contenu change.
add(E e) ajoute une constante absente. Un nouvel ajout de la même constante renvoie false et ne crée pas de doublon. contains(Object o) renvoie true si l’élément est présent, sans modifier l’ensemble. remove(Object o) retire un élément présent et renvoie false s’il était déjà absent.
add prend un élément de type E, tandis que contains et remove prennent un Object. Une chaîne n’est pas convertie en constante de l’énumération : "WRITE" ne correspond pas à Permission.WRITE. add(null) lève une NullPointerException ; contains(null) et remove(null) renvoient false.
L’itérateur ne parcourt que les constantes présentes, dans leur ordre de déclaration dans l’énumération. Si READ est déclaré avant WRITE, la boucle visite READ en premier, même si WRITE a été ajouté avant.
Exemples
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));
}
}Résultat
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` est ajouté en premier, mais la boucle affiche `READ` avant `WRITE`. Le premier retrait de `WRITE` renvoie `true`, le second renvoie `false`, et le dernier test de présence renvoie aussi `false`.
Leçons associées
- Java · Leçon 19 · Avancé · Version : 2