Enums com Métodos

Parte da seção Programação Orientada a Objetos do Journey de Dart da Coddy — lição 88 de 110.

No Dart, enums não são apenas listas simples de constantes - eles podem ter campos, construtores e métodos, tornando-os mini-classes poderosas. Isso é chamado de enhanced enums, e permite que você anexe comportamento e dados diretamente a cada valor de 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);    // false
  
  print(Status.approved.isFinalized);  // true
}

Cada valor de enum chama o construtor com seus argumentos específicos. O construtor deve ser const, e todos os campos devem ser final. Você pode adicionar getters e métodos que funcionam com os dados do enum ou comparam com outros valores.

Enums aprimorados também podem implementar interfaces, dando-lhes ainda mais flexibilidade:

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]
}

Enums aprimorados são ideais quando você tem um conjunto fixo de valores que cada um precisa de dados ou comportamentos associados - como códigos de status com mensagens, prioridades com níveis ou direções com coordenadas.

Desafio

Fácil

Vamos construir um sistema de gerenciamento de tarefas usando enums aprimorados! Você criará um enum que representa diferentes categorias de tarefas, cada uma com suas próprias propriedades e comportamentos que ajudam a organizar e priorizar o trabalho.

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

task_category.dart: Crie um enum aprimorado chamado TaskCategory que representa diferentes tipos de tarefas em um projeto. Cada categoria deve ter:
- Um campo String label para um nome legível por humanos
- Um campo int priority (1 sendo a prioridade mais alta, 3 sendo a mais baixa)
- Um construtor const que inicializa ambos os campos
- Quatro valores de enum: bug (label: "Bug Fix", priority: 1), feature (label: "New Feature", priority: 2), documentation (label: "Documentation", priority: 3), e testing (label: "Testing", priority: 2)
- Um getter isUrgent que retorna true se a prioridade for 1
- Um método describe() que retorna uma string no formato: [label] (Priority: [priority])
Seu enum também deve implementar Comparable<TaskCategory> para que as tarefas possam ser ordenadas por prioridade (número de prioridade menor = vem primeiro).
main.dart: Importe seu enum de categoria de tarefa e demonstre suas capacidades:
- Crie uma lista contendo todas as quatro categorias de tarefas nesta ordem: feature, bug, documentation, testing
- Imprima a descrição de cada categoria usando o método describe(), uma por linha
- Imprima uma linha vazia
- Ordene a lista por prioridade e imprima After sorting by priority:
- Imprima o label de cada categoria ordenada, um por linha
- Imprima uma linha vazia
- Imprima Urgent tasks:
- Percorra a ordem original (feature, bug, documentation, testing) e imprima apenas os labels das categorias onde isUrgent for true

Este desafio combina recursos de enums aprimorados: campos, construtores, getters, métodos e implementação de interfaces - todos trabalhando juntos para criar um sistema útil de categorização de tarefas!

Saída esperada:

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

Folha de consulta

Enums aprimorados (enhanced enums) no Dart podem ter campos, construtores e métodos, tornando-os mini-classes poderosas que anexam comportamento e dados a cada valor do enum.

Enum aprimorado básico com campos e construtor:

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

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

Requisitos principais:

O construtor deve ser const
Todos os campos devem ser final
Cada valor do enum chama o construtor com argumentos específicos

Enums aprimorados podem incluir getters e métodos:

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

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

Enums aprimorados podem implementar interfaces como 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);
}

Use enums aprimorados quando você tiver um conjunto fixo de valores onde cada um precise de dados ou comportamentos associados.

Experimente você mesmo

import 'task_category.dart';

void main() {
  // TODO: Crie uma lista contendo todas as quatro categorias de tarefas nesta ordem:
  // feature, bug, documentation, testing
  
  // TODO: Imprima a descrição de cada categoria usando describe(), uma por linha
  
  // TODO: Imprima uma linha vazia
  
  // TODO: Ordene a lista por prioridade
  
  // TODO: Imprima "After sorting by priority:"
  
  // TODO: Imprima o rótulo de cada categoria ordenada, um por linha
  
  // TODO: Imprima uma linha vazia
  
  // TODO: Imprima "Urgent tasks:"
  
  // TODO: Percorra a ordem original (feature, bug, documentation, testing)
  // e imprima apenas os rótulos das categorias onde isUrgent é verdadeiro
}