Padrão Repository

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

O padrão Repository separa a lógica de acesso a dados da lógica de negócio ao criar uma camada de abstração entre sua aplicação e as fontes de dados. Em vez de fazer com que suas classes interajam diretamente com bancos de dados, APIs ou arquivos, elas trabalham com um repositório que gerencia todas as operações de dados.

O padrão define uma interface para operações de dados, e as implementações concretas lidam com o mecanismo de armazenamento real. Isso facilita a troca de fontes de dados sem alterar sua lógica de negócios:

// Entidade
class User {
  final int id;
  final String name;
  User(this.id, this.name);
}

// Interface do repositório
abstract class UserRepository {
  User? getById(int id);
  List<User> getAll();
  void save(User user);
  void delete(int id);
}

// Implementação em memória
class InMemoryUserRepository implements UserRepository {
  final Map<int, User> _users = {};

  @override
  User? getById(int id) => _users[id];

  @override
  List<User> getAll() => _users.values.toList();

  @override
  void save(User user) => _users[user.id] = user;

  @override
  void delete(int id) => _users.remove(id);
}

void main() {
  UserRepository repo = InMemoryUserRepository();
  
  repo.save(User(1, 'Alice'));
  repo.save(User(2, 'Bob'));
  
  print(repo.getById(1)?.name);  // Alice
  print(repo.getAll().length);    // 2
}

Sua lógica de negócio depende apenas da interface UserRepository. Você poderia criar posteriormente um DatabaseUserRepository ou ApiUserRepository que implemente a mesma interface, e trocar as implementações sem modificar nenhum código que utilize o repositório. Este padrão é essencial para aplicações testáveis e de fácil manutenção, onde as fontes de dados podem mudar ao longo do tempo.

Desafio

Fácil

Vamos construir um sistema de inventário de produtos usando o padrão Repository! Você criará uma camada de abstração que separa como os produtos são armazenados de como eles são usados, facilitando a troca de implementações de armazenamento sem alterar a lógica de negócio.

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

product_repository.dart: Este arquivo contém sua entidade e as classes do repositório. Comece com uma classe Product que possui campos final para id (int), name (String) e price (double). Em seguida, defina uma classe abstrata ProductRepository que declara o contrato para operações de dados: getById(int id) retornando um Product anulável, getAll() retornando uma lista de produtos, save(Product product) para armazenar um produto e delete(int id) para remover um. Por fim, crie um InMemoryProductRepository que implementa esta interface usando um Map<int, Product> para armazenamento.
main.dart: Importe seu arquivo de repositório e demonstre o padrão Repository em ação. Crie um InMemoryProductRepository, mas armazene-o em uma variável do tipo ProductRepository - isso mostra como seu código depende da interface, não da implementação. Salve três produtos: Laptop (id: 1, price: 999.99), Mouse (id: 2, price: 29.99) e Keyboard (id: 3, price: 79.99). Em seguida, recupere e imprima o produto com id 2 no formato Found: [name] - $[price]. Exclua o produto com id 1. Por fim, imprima a contagem de produtos restantes como Products in stock: [count].

O poder deste padrão é que seu código principal conhece apenas a interface ProductRepository. Você poderia criar posteriormente um DatabaseProductRepository ou ApiProductRepository e trocá-lo sem alterar nada da lógica de negócio!

Saída esperada:

Found: Mouse - $29.99
Products in stock: 2

Folha de consulta

O padrão Repository separa a lógica de acesso a dados da lógica de negócios, criando uma camada de abstração entre sua aplicação e as fontes de dados.

Defina uma interface para operações de dados:

// Entidade
class User {
  final int id;
  final String name;
  User(this.id, this.name);
}

// Interface do repositório
abstract class UserRepository {
  User? getById(int id);
  List<User> getAll();
  void save(User user);
  void delete(int id);
}

Crie implementações concretas que lidam com o mecanismo de armazenamento real:

// Implementação em memória
class InMemoryUserRepository implements UserRepository {
  final Map<int, User> _users = {};

  @override
  User? getById(int id) => _users[id];

  @override
  List<User> getAll() => _users.values.toList();

  @override
  void save(User user) => _users[user.id] = user;

  @override
  void delete(int id) => _users.remove(id);
}

Use o repositório através de sua interface:

void main() {
  UserRepository repo = InMemoryUserRepository();
  
  repo.save(User(1, 'Alice'));
  repo.save(User(2, 'Bob'));
  
  print(repo.getById(1)?.name);  // Alice
  print(repo.getAll().length);    // 2
}

A lógica de negócios depende apenas da interface, permitindo que você troque as implementações (ex: DatabaseUserRepository, ApiUserRepository) sem modificar o código que utiliza o repositório.

Experimente você mesmo

import 'product_repository.dart';

void main() {
  // Criar repositório - note que o tipo é a interface, não a implementação
  // TODO: Criar um InMemoryProductRepository e armazená-lo em uma variável ProductRepository
  
  // TODO: Salvar três produtos:
  // - Laptop (id: 1, price: 999.99)
  // - Mouse (id: 2, price: 29.99)
  // - Keyboard (id: 3, price: 79.99)
  
  // TODO: Recuperar o produto com id 2 e imprimir: "Found: [name] - $[price]"
  
  // TODO: Excluir o produto com id 1
  
  // TODO: Imprimir a contagem de produtos restantes: "Products in stock: [count]"
}