Padrão Factory

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

O padrão Factory delega a criação de objetos a um método ou classe separado, permitindo que você crie objetos sem especificar sua classe exata. Isso é diferente do construtor factory que você aprendeu anteriormente — o padrão Factory é uma abordagem de design na qual a lógica de criação é centralizada e pode retornar tipos diferentes com base na entrada.

Considere um cenário em que você precisa criar diferentes tipos de notificações. Em vez de o cliente decidir qual classe instanciar, uma fábrica cuida dessa decisão:

abstract class Notification {
  void send(String message);
}

class EmailNotification implements Notification {
  @override
  void send(String message) => print('Email: $message');
}

class SMSNotification implements Notification {
  @override
  void send(String message) => print('SMS: $message');
}

class NotificationFactory {
  static Notification create(String type) {
    switch (type) {
      case 'email':
        return EmailNotification();
      case 'sms':
        return SMSNotification();
      default:
        return EmailNotification();
    }
  }
}

void main() {
  var notification = NotificationFactory.create('sms');
  notification.send('Hello!');  // SMS: Hello!
}

O código cliente não precisa conhecer EmailNotification ou SMSNotification — ele apenas solicita à fábrica uma notificação de um determinado tipo. Isso facilita a adição de novos tipos de notificação: você modifica apenas a fábrica, não todos os lugares que criam notificações.

Use o padrão Factory quando a criação de objetos envolver lógica complexa, quando você quiser ocultar as classes de implementação dos clientes ou quando o tipo exato a ser criado depender de condições em tempo de execução.

Desafio

Fácil

Vamos criar um gerador de documentos usando o padrão Factory! Você criará um sistema que produz diferentes tipos de documentos (relatórios, faturas e cartas) por meio de uma factory centralizada, para que o código cliente não precise conhecer as classes de documentos específicas.

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

document_factory.dart: crie seu sistema de documentos aqui:
- Uma classe abstrata Document com um método generate(String content) que retorna uma String
- Três classes concretas que implementam Document:
  - Report - seu método generate retorna === REPORT ===\n[content]\n=============
  - Invoice - seu método generate retorna INVOICE\n--------\n[content]\nTotal Due
  - Letter - seu método generate retorna Dear Reader,\n[content]\nSincerely
- Uma classe DocumentFactory com um método estático create(String type) que retorna o Document apropriado com base na string de tipo: "report", "invoice" ou "letter". Para qualquer tipo desconhecido, retorne um Letter como padrão
main.dart: importe sua factory de documentos e demonstre como a factory cria diferentes tipos de documentos sem que o cliente precise conhecer as classes concretas:
- Use a factory para criar um relatório e imprima o resultado de gerá-lo com o conteúdo Sales increased by 25%
- Imprima uma linha vazia
- Use a factory para criar uma fatura e imprima o resultado de gerá-la com o conteúdo Widget x3 - $150
- Imprima uma linha vazia
- Use a factory para criar uma carta e imprima o resultado de gerá-la com o conteúdo Thank you for your order

Observe como seu arquivo principal interage apenas com a factory e com o tipo abstrato Document — ele nunca cria diretamente objetos Report, Invoice ou Letter!

Saída esperada:

=== REPORT ===
Sales increased by 25%
=============

INVOICE
--------
Widget x3 - $150
Total Due

Dear Reader,
Thank you for your order
Sincerely

Experimente você mesmo

import 'document_factory.dart';

void main() {
  // TODO: Use DocumentFactory.create() para criar um relatório
  // Em seguida, imprima o resultado de gerá-lo com o conteúdo: "Sales increased by 25%"
  
  // TODO: Imprima uma linha vazia
  
  // TODO: Use DocumentFactory.create() para criar uma fatura
  // Em seguida, imprima o resultado de gerá-lo com o conteúdo: "Widget x3 - \$150"
  
  // TODO: Imprima uma linha vazia
  
  // TODO: Use DocumentFactory.create() para criar uma carta
  // Em seguida, imprima o resultado de gerá-lo com o conteúdo: "Thank you for your order"
}