Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources