Patron Repository

Fait partie de la section Programmation Orientée Objet du Journey Dart de Coddy — leçon 100 sur 110.

Le modèle Repository sépare la logique d'accès aux données de la logique métier en créant une couche d'abstraction entre votre application et les sources de données. Au lieu que vos classes interagissent directement avec des bases de données, des API ou des fichiers, elles travaillent avec un repository qui gère toutes les opérations de données.

Le patron définit une interface pour les opérations de données, et les implémentations concrètes gèrent le mécanisme de stockage réel. Cela permet de changer facilement de source de données sans modifier votre logique métier :

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

// Interface du dépôt
abstract class UserRepository {
  User? getById(int id);
  List<User> getAll();
  void save(User user);
  void delete(int id);
}

// Implémentation en mémoire
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
}

Votre logique métier dépend uniquement de l'interface UserRepository. Vous pourriez créer plus tard un DatabaseUserRepository ou un ApiUserRepository qui implémente la même interface, et échanger les implémentations sans modifier le code qui utilise le repository. Ce modèle est essentiel pour des applications testables et maintenables où les sources de données peuvent changer au fil du temps.

Défi

Facile

Construisons un système d'inventaire de produits en utilisant le pattern Repository ! Vous allez créer une couche d'abstraction qui sépare la manière dont les produits sont stockés de la manière dont ils sont utilisés, ce qui facilite le remplacement des implémentations de stockage sans modifier la logique métier.

Vous organiserez votre code en deux fichiers :

product_repository.dart : Ce fichier contient votre entité et vos classes de dépôt. Commencez par une classe Product qui possède des champs final pour id (int), name (String) et price (double). Définissez ensuite une classe abstraite ProductRepository qui déclare le contrat pour les opérations de données : getById(int id) retournant un Product nullable, getAll() retournant une liste de produits, save(Product product) pour stocker un produit, et delete(int id) pour en supprimer un. Enfin, créez un InMemoryProductRepository qui implémente cette interface en utilisant une Map<int, Product> pour le stockage.
main.dart : Importez votre fichier de dépôt et démontrez le pattern Repository en action. Créez un InMemoryProductRepository mais stockez-le dans une variable de type ProductRepository - cela montre comment votre code dépend de l'interface, et non de l'implémentation. Enregistrez trois produits : Laptop (id: 1, price: 999.99), Mouse (id: 2, price: 29.99), et Keyboard (id: 3, price: 79.99). Ensuite, récupérez et affichez le produit avec l'id 2 au format Found: [name] - $[price]. Supprimez le produit avec l'id 1. Enfin, affichez le nombre de produits restants sous la forme Products in stock: [count].

La puissance de ce pattern est que votre code principal ne connaît que l'interface ProductRepository. Vous pourriez plus tard créer un DatabaseProductRepository ou un ApiProductRepository et le remplacer sans changer aucune logique métier !

Sortie attendue :

Found: Mouse - $29.99
Products in stock: 2

Aide-mémoire

Le modèle Repository sépare la logique d'accès aux données de la logique métier en créant une couche d'abstraction entre votre application et les sources de données.

Définissez une interface pour les opérations de données :

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

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

Créez des implémentations concrètes qui gèrent le mécanisme de stockage réel :

// Implémentation en mémoire
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);
}

Utilisez le repository via son 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
}

La logique métier dépend uniquement de l'interface, ce qui vous permet d'échanger les implémentations (par exemple, DatabaseUserRepository, ApiUserRepository) sans modifier le code qui utilise le repository.

Essayez vous-même

import 'product_repository.dart';

void main() {
  // Créer le dépôt - notez que le type est l'interface, pas l'implémentation
  // TODO: Créer un InMemoryProductRepository et le stocker dans une variable ProductRepository
  
  // TODO: Enregistrer trois produits :
  // - Laptop (id: 1, price: 999.99)
  // - Mouse (id: 2, price: 29.99)
  // - Keyboard (id: 3, price: 79.99)
  
  // TODO: Récupérer le produit avec l'id 2 et afficher : "Found: [name] - $[price]"
  
  // TODO: Supprimer le produit avec l'id 1
  
  // TODO: Afficher le nombre de produits restants : "Products in stock: [count]"
}