Classes scellées (Dart 3)

Fait partie de la section Programmation Orientée Objet du Journey Dart de Coddy. Leçon 85 sur 110.

Dart 3 a introduit les classes scellées, qui restreignent les classes pouvant les étendre ou les implémenter. Lorsque vous marquez une classe comme sealed, seules les classes du même fichier peuvent être ses sous-types directs. Cela crée un ensemble fermé de sous-types connus.

sealed class Result {}

class Success extends Result {
  final String data;
  Success(this.data);
}

class Failure extends Result {
  final String error;
  Failure(this.error);
}

La puissance des classes scellées provient de la vérification de l'exhaustivité. Lorsque vous effectuez un switch sur un type scellé, le compilateur connaît tous les sous-types possibles et s'assure que vous traitez chacun d'entre eux :

String handleResult(Result result) {
  return switch (result) {
    Success(data: var d) => 'Got: $d',
    Failure(error: var e) => 'Error: $e',
  };
  // Pas de cas par défaut nécessaire - le compilateur sait que tous les cas sont couverts !
}

void main() {
  var success = Success('Hello');
  var failure = Failure('Not found');
  
  print(handleResult(success));  // Got: Hello
  print(handleResult(failure));  // Error: Not found
}

Si vous ajoutez un nouveau sous-type à une classe scellée, le compilateur signalera chaque instruction switch qui ne le prend pas en charge. Cela rend les classes scellées idéales pour modéliser des états, des résultats ou tout scénario dans lequel vous disposez d’un ensemble fixe de variantes. Contrairement aux classes abstraites, les classes scellées garantissent qu’aucun code externe ne peut ajouter de sous-types inattendus.

Défi

Facile

Construisons un gestionnaire de requêtes réseau à l’aide de classes scellées ! Tu vas créer un système offrant la sécurité des types qui modélise les différents états d’une réponse réseau, en veillant à ce que chaque résultat possible soit correctement pris en charge.

Tu organiseras ton code en deux fichiers :

response.dart : Crée une hiérarchie de classes scellées qui représente tous les états possibles d’une réponse réseau :
- Une classe scellée appelée NetworkResponse qui sert de base à tous les types de réponses
- Une classe Loading qui étend NetworkResponse avec un champ String message (par exemple, "Fetching data...")
- Une classe Success qui étend NetworkResponse avec un champ String data et un champ int statusCode
- Une classe Error qui étend NetworkResponse avec un champ String errorMessage et un champ int errorCode
main.dart : Importe ton fichier de réponse et crée une fonction qui gère tous les types de réponses à l’aide d’une expression switch :
- Crée une fonction handleResponse(NetworkResponse response) qui renvoie une String
- Utilise une expression switch avec la correspondance de motifs pour gérer chaque cas :
  - Pour Loading : renvoie Status: [message]
  - Pour Success : renvoie Success ([statusCode]): [data]
  - Pour Error : renvoie Error ([errorCode]): [errorMessage]
- Crée trois instances de réponses et affiche le résultat du traitement de chacune :
  - Un Loading avec le message Please wait...
  - Un Success avec les données User profile loaded et le code d’état 200
  - Un Error avec le message d’erreur Not found et le code d’erreur 404

L’intérêt des classes scellées est que le compilateur garantit que tu gères tous les types de réponses possibles : aucun cas par défaut n’est nécessaire !

Sortie attendue :

Status: Please wait...
Success (200): User profile loaded
Error (404): Not found

Essayez vous-même

import 'response.dart';

// TODO: Créer une fonction handleResponse(NetworkResponse response)
// qui retourne un String
// Utiliser une expression switch avec du pattern matching pour gérer chaque cas :
// - Pour Loading : retourner "Status: [message]"
// - Pour Success : retourner "Success ([statusCode]): [data]"
// - Pour Error : retourner "Error ([errorCode]): [errorMessage]"

void main() {
  // TODO: Créer une instance de Loading avec le message "Please wait..."
  
  // TODO: Créer une instance de Success avec la donnée "User profile loaded" et le code de statut 200
  
  // TODO: Créer une instance de Error avec le message d'erreur "Not found" et le code d'erreur 404
  
  // TODO: Afficher le résultat du traitement de chaque réponse
}