Classes Seladas (Dart 3)

Parte da seção Programação Orientada a Objetos do Journey de Dart da Coddy. Lição 85 de 110.

O Dart 3 introduziu classes seladas, que restringem quais classes podem estendê-las ou implementá-las. Quando você marca uma classe como sealed, somente classes no mesmo arquivo podem ser seus subtipos diretos. Isso cria um conjunto fechado de subtipos conhecidos.

sealed class Result {}

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

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

O poder das classes seladas vem da verificação de exaustividade. Quando você utiliza um switch em um tipo selado, o compilador conhece todos os subtipos possíveis e garante que você trate cada um deles:

String handleResult(Result result) {
  return switch (result) {
    Success(data: var d) => 'Got: $d',
    Failure(error: var e) => 'Error: $e',
  };
  // Nenhum padrão é necessário - o compilador sabe que todos os casos estão cobertos!
}

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

Se você adicionar um novo subtipo a uma classe selada, o compilador sinalizará toda instrução switch que não o tratar. Isso torna as classes seladas ideais para modelar estados, resultados ou qualquer cenário em que você tenha um conjunto fixo de variantes. Diferentemente das classes abstratas, as classes seladas garantem que nenhum código externo possa adicionar subtipos inesperados.

Desafio

Fácil

Vamos criar um manipulador de requisições de rede usando classes seladas! Você criará um sistema seguro em relação aos tipos que modela diferentes estados de uma resposta de rede, garantindo que todo resultado possível seja tratado corretamente.

Você organizará seu código em dois arquivos:

response.dart: Crie uma hierarquia de classes seladas que represente todos os estados possíveis de uma resposta de rede:
- Uma classe selada chamada NetworkResponse que serve como base para todos os tipos de resposta
- Uma classe Loading que estende NetworkResponse com um campo String message (por exemplo, "Fetching data...")
- Uma classe Success que estende NetworkResponse com um campo String data e um campo int statusCode
- Uma classe Error que estende NetworkResponse com um campo String errorMessage e um campo int errorCode
main.dart: Importe seu arquivo de resposta e crie uma função que trate todos os tipos de resposta usando uma expressão switch:
- Crie uma função handleResponse(NetworkResponse response) que retorne uma String
- Use uma expressão switch com correspondência de padrões para tratar cada caso:
  - Para Loading: retorne Status: [message]
  - Para Success: retorne Success ([statusCode]): [data]
  - Para Error: retorne Error ([errorCode]): [errorMessage]
- Crie três instâncias de resposta e imprima o resultado do tratamento de cada uma:
  - Um Loading com a mensagem Please wait...
  - Um Success com os dados User profile loaded e o código de status 200
  - Um Error com a mensagem de erro Not found e o código de erro 404

A vantagem das classes seladas é que o compilador garante que você trate todos os tipos de resposta possíveis — nenhum caso padrão é necessário!

Saída esperada:

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

Experimente você mesmo

import 'response.dart';

// TODO: Crie uma função handleResponse(NetworkResponse response)
// que retorna uma String
// Use uma switch expression com pattern matching para lidar com cada caso:
// - Para Loading: retorne "Status: [message]"
// - Para Success: retorne "Success ([statusCode]): [data]"
// - Para Error: retorne "Error ([errorCode]): [errorMessage]"

void main() {
  // TODO: Crie uma instância de Loading com a mensagem "Please wait..."
  
  // TODO: Crie uma instância de Success com os dados "User profile loaded" e o status code 200
  
  // TODO: Crie uma instância de Error com a mensagem de erro "Not found" e o error code 404
  
  // TODO: Imprima o resultado do tratamento de cada resposta
}