Pattern Repository

Fa parte della sezione Programmazione orientata agli oggetti del percorso Dart di Coddy. Lezione 100 di 110.

Il pattern Repository separa la logica di accesso ai dati dalla logica di business creando un livello di astrazione tra la tua applicazione e le fonti dati. Invece di far interagire direttamente le tue classi con database, API o file, queste lavorano con un repository che gestisce tutte le operazioni sui dati.

Il modello definisce un'interfaccia per le operazioni sui dati e le implementazioni concrete gestiscono il meccanismo di archiviazione effettivo. Questo consente di sostituire facilmente le fonti di dati senza modificare la logica aziendale:

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

// Repository interface
abstract class UserRepository {
  User? getById(int id);
  List<User> getAll();
  void save(User user);
  void delete(int id);
}

// In-memory implementation
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
}

La tua logica di business dipende solo dall'interfaccia UserRepository. In seguito potresti creare un DatabaseUserRepository o un ApiUserRepository che implementa la stessa interfaccia e sostituire le implementazioni senza modificare alcun codice che utilizza il repository. Questo schema è essenziale per applicazioni testabili e manutenibili, in cui le origini dei dati possono cambiare nel tempo.

Sfida

Facile

Costruiamo un sistema di inventario dei prodotti usando il pattern Repository! Creerai un livello di astrazione che separa il modo in cui i prodotti vengono archiviati da quello in cui vengono utilizzati, rendendo semplice sostituire le implementazioni di archiviazione senza modificare la logica aziendale.

Organizzerai il codice in due file:

product_repository.dart: questo file contiene le classi entità e repository. Inizia con una classe Product che ha campi final per id (int), name (String) e price (double). Poi definisci una classe astratta ProductRepository che dichiara il contratto per le operazioni sui dati: getById(int id), che restituisce un Product nullable, getAll(), che restituisce una lista di prodotti, save(Product product) per archiviare un prodotto e delete(int id) per rimuoverne uno. Infine, crea un InMemoryProductRepository che implementa questa interfaccia usando un Map<int, Product> per l'archiviazione.
main.dart: importa il file del repository e mostra il pattern Repository in azione. Crea un InMemoryProductRepository, ma assegnalo a una variabile di tipo ProductRepository: questo mostra come il codice dipenda dall'interfaccia e non dall'implementazione. Salva tre prodotti: Laptop (id: 1, prezzo: 999.99), Mouse (id: 2, prezzo: 29.99) e Keyboard (id: 3, prezzo: 79.99). Poi recupera e stampa il prodotto con id 2 nel formato Found: [name] - $[price]. Elimina il prodotto con id 1. Infine, stampa il numero di prodotti rimanenti come Products in stock: [count].

Il vantaggio di questo pattern è che il codice principale conosce solo l'interfaccia ProductRepository. In seguito potresti creare un DatabaseProductRepository o un ApiProductRepository e sostituirlo senza modificare la logica aziendale!

Output previsto:

Found: Mouse - $29.99
Products in stock: 2

Provalo tu

import 'product_repository.dart';

void main() {
  // Crea il repository: nota che il tipo è l'interfaccia, non l'implementazione
  // TODO: Crea un InMemoryProductRepository e memorizzalo in una variabile ProductRepository
  
  // TODO: Salva tre prodotti:
  // - Laptop (id: 1, price: 999.99)
  // - Mouse (id: 2, price: 29.99)
  // - Keyboard (id: 3, price: 79.99)
  
  // TODO: Recupera il prodotto con id 2 e stampa: "Found: [name] - $[price]"
  
  // TODO: Elimina il prodotto con id 1
  
  // TODO: Stampa il numero di prodotti rimanenti: "Products in stock: [count]"
}