Enums avec méthodes

Fait partie de la section Programmation Orientée Objet du Journey Dart de Coddy — leçon 88 sur 110.

En Dart, les enums ne sont pas seulement de simples listes de constantes - elles peuvent avoir des champs, des constructeurs et des méthodes, ce qui en fait de puissantes mini-classes. C'est ce qu'on appelle les enums améliorées, et cela vous permet d'attacher du comportement et des données directement à chaque valeur de l'enum.

enum Status {
  pending('Waiting'),
  approved('Accepted'),
  rejected('Denied');

  final String displayName;
  
  const Status(this.displayName);
  
  bool get isFinalized => this == approved || this == rejected;
}

void main() {
  var status = Status.pending;
  print(status.displayName);    // Waiting
  print(status.isFinalized);    // faux
  
  print(Status.approved.isFinalized);  // vrai
}

Chaque valeur d'énumération appelle le constructeur avec ses arguments spécifiques. Le constructeur doit être const, et tous les champs doivent être final. Vous pouvez ajouter des getters et des méthodes qui travaillent avec les données de l'énumération ou les comparent à d'autres valeurs.

Les énumérations améliorées peuvent également implémenter des interfaces, ce qui leur donne encore plus de flexibilité :

enum Priority implements Comparable<Priority> {
  low(1),
  medium(2),
  high(3);

  final int level;
  const Priority(this.level);

  @override
  int compareTo(Priority other) => level.compareTo(other.level);
}

void main() {
  var tasks = [Priority.high, Priority.low, Priority.medium];
  tasks.sort();
  print(tasks);  // [Priority.low, Priority.medium, Priority.high]
}

Les enums améliorées sont idéales lorsque vous avez un ensemble fixe de valeurs qui nécessitent chacune des données ou un comportement associés - comme des codes d'état avec des messages, des priorités avec des niveaux ou des directions avec des coordonnées.

Défi

Facile

Construisons un système de gestion de tâches en utilisant des enums améliorés ! Vous allez créer un enum qui représente différentes catégories de tâches, chacune avec ses propres propriétés et comportements qui aident à organiser et à prioriser le travail.

Vous organiserez votre code en deux fichiers :

task_category.dart : Créez un enum amélioré appelé TaskCategory qui représente différents types de tâches dans un projet. Chaque catégorie doit avoir :
- Un champ String label pour un nom lisible par l'homme
- Un champ int priority (1 étant la priorité la plus élevée, 3 la plus basse)
- Un constructeur const qui initialise les deux champs
- Quatre valeurs d'enum : bug (label: "Bug Fix", priority: 1), feature (label: "New Feature", priority: 2), documentation (label: "Documentation", priority: 3), et testing (label: "Testing", priority: 2)
- Un getter isUrgent qui retourne true si la priorité est 1
- Une méthode describe() qui retourne une chaîne de caractères au format : [label] (Priority: [priority])
Votre enum doit également implémenter Comparable<TaskCategory> afin que les tâches puissent être triées par priorité (un numéro de priorité plus bas = vient en premier).
main.dart : Importez votre enum de catégorie de tâche et démontrez ses capacités :
- Créez une liste contenant les quatre catégories de tâches dans cet ordre : feature, bug, documentation, testing
- Affichez la description de chaque catégorie en utilisant la méthode describe(), une par ligne
- Affichez une ligne vide
- Triez la liste par priorité et affichez After sorting by priority:
- Affichez le label de chaque catégorie triée, un par ligne
- Affichez une ligne vide
- Affichez Urgent tasks:
- Parcourez l'ordre original (feature, bug, documentation, testing) et affichez uniquement les labels des catégories où isUrgent est vrai

Ce défi combine les fonctionnalités des enums améliorés : champs, constructeurs, getters, méthodes et implémentation d'interfaces - le tout travaillant ensemble pour créer un système de catégorisation de tâches utile !

Sortie attendue :

New Feature (Priority: 2)
Bug Fix (Priority: 1)
Documentation (Priority: 3)
Testing (Priority: 2)

After sorting by priority:
Bug Fix
New Feature
Testing
Documentation

Urgent tasks:
Bug Fix

Aide-mémoire

Les enums améliorés en Dart peuvent avoir des champs, des constructeurs et des méthodes, ce qui en fait de puissantes mini-classes qui attachent un comportement et des données à chaque valeur d'enum.

Enum amélioré de base avec des champs et un constructeur :

enum Status {
  pending('Waiting'),
  approved('Accepted'),
  rejected('Denied');

  final String displayName;
  
  const Status(this.displayName);
}

Exigences clés :

Le constructeur doit être const
Tous les champs doivent être final
Chaque valeur d'enum appelle le constructeur avec des arguments spécifiques

Les enums améliorés peuvent inclure des getters et des méthodes :

enum Status {
  pending('Waiting'),
  approved('Accepted'),
  rejected('Denied');

  final String displayName;
  const Status(this.displayName);
  
  bool get isFinalized => this == approved || this == rejected;
}

Les enums améliorés peuvent implémenter des interfaces comme Comparable :

enum Priority implements Comparable<Priority> {
  low(1),
  medium(2),
  high(3);

  final int level;
  const Priority(this.level);

  @override
  int compareTo(Priority other) => level.compareTo(other.level);
}

Utilisez les enums améliorés lorsque vous avez un ensemble fixe de valeurs qui nécessitent chacune des données ou un comportement associés.

Essayez vous-même

import 'task_category.dart';

void main() {
  // TODO: Créer une liste contenant les quatre catégories de tâches dans cet ordre :
  // feature, bug, documentation, testing
  
  // TODO: Afficher la description de chaque catégorie en utilisant describe(), une par ligne
  
  // TODO: Afficher une ligne vide
  
  // TODO: Trier la liste par priority
  
  // TODO: Afficher "After sorting by priority:"
  
  // TODO: Afficher le label de chaque catégorie triée, un par ligne
  
  // TODO: Afficher une ligne vide
  
  // TODO: Afficher "Urgent tasks:"
  
  // TODO: Parcourir l'ordre original (feature, bug, documentation, testing)
  // et afficher uniquement les labels des catégories où isUrgent est true
}