Padrão Repository

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

O Repository Pattern é um padrão de projeto que atua como intermediário entre a lógica de negócio da sua aplicação e o armazenamento de dados. Ele fornece uma interface semelhante a uma coleção para acessar objetos de domínio, ocultando os detalhes de como os dados são realmente armazenados ou recuperados.

Pense em um repositório como uma coleção especializada que sabe como persistir e recuperar objetos. Seu código da aplicação solicita ao repositório um usuário por ID ou salva um novo produto, sem saber se os dados estão em um banco de dados, arquivo ou API. Essa separação torna seu código mais testável e flexível.

<?php
interface UserRepositoryInterface {
    public function find(int $id): ?User;
    public function findAll(): array;
    public function save(User $user): void;
    public function delete(int $id): void;
}

class User {
    public function __construct(
        public int $id,
        public string $name,
        public string $email
    ) {}
}

A implementação do repositório lida com o mecanismo de armazenamento real:

<?php
class InMemoryUserRepository implements UserRepositoryInterface {
    private array $users = [];
    
    public function find(int $id): ?User {
        return $this->users[$id] ?? null;
    }
    
    public function findAll(): array {
        return array_values($this->users);
    }
    
    public function save(User $user): void {
        $this->users[$user->id] = $user;
    }
    
    public function delete(int $id): void {
        unset($this->users[$id]);
    }
}

$repo = new InMemoryUserRepository();
$repo->save(new User(1, "Alice", "alice@example.com"));
$repo->save(new User(2, "Bob", "bob@example.com"));

echo $repo->find(1)->name . "\n";
echo count($repo->findAll());

Saída:

Alice
2

A beleza desse padrão é que você pode trocar as implementações sem alterar sua lógica de negócio. Precisa mudar do armazenamento em memória para um banco de dados? Crie uma nova classe de repositório que implemente a mesma interface. O código da sua aplicação permanece intocado porque depende da interface, não da implementação concreta.

Desafio

Fácil

Vamos criar um sistema de inventário de produtos usando o Padrão Repositório. Você criará uma separação clara entre seus objetos de domínio e a forma como eles são armazenados, permitindo que o código da sua aplicação trabalhe com produtos sem conhecer os detalhes do armazenamento.

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

Product.php: Crie uma classe Product que represente os itens do seu inventário. Cada produto tem um id (int), um name (string) e um price (float). Use a promoção de construtor com propriedades públicas para facilitar o acesso.
ProductRepositoryInterface.php: Defina uma ProductRepositoryInterface que estabeleça o contrato para qualquer implementação de armazenamento de produtos. Sua interface deve declarar estes métodos:
- find(int $id): ?Product: Recupere um produto pelo ID ou retorne null se não for encontrado
- findAll(): array: Obtenha todos os produtos como um array
- save(Product $product): void: Armazene ou atualize um produto
- delete(int $id): void: Remova um produto pelo ID
InMemoryProductRepository.php: Inclua tanto a classe Product quanto a interface. Crie uma classe InMemoryProductRepository que implemente a interface usando um array privado para armazenar os produtos. Os produtos devem ser indexados pelo ID para uma busca eficiente. O método findAll() deve retornar apenas os objetos de produto (use array_values() para redefinir as chaves do array).
main.php: Inclua o arquivo do repositório. Você receberá duas entradas: primeiro, uma string JSON de produtos a serem adicionados; depois, em uma linha separada, o ID inteiro a ser pesquisado.
O formato JSON será:
```
[{"id": 1, "name": "Laptop", "price": 999.99}, {"id": 2, "name": "Mouse", "price": 29.99}]
```
Crie um InMemoryProductRepository, salve todos os produtos da entrada JSON e, em seguida, use a segunda entrada (o ID) para encontrar um produto específico. Imprima os resultados neste formato:
```
Total products: [count]
Found: [name] - $[price]
```
Formate o preço com duas casas decimais. Se o produto não for encontrado, imprima Found: Not found.

O Padrão Repositório se destaca quando você precisa trocar as implementações de armazenamento. Seu código principal depende apenas da interface: mudar do armazenamento em memória para um banco de dados significaria criar uma nova classe de repositório sem alterar nenhuma lógica da aplicação.

Experimente você mesmo

<?php

require_once 'InMemoryProductRepository.php';

// Ler a entrada
$jsonInput = trim(fgets(STDIN));
$searchId = intval(trim(fgets(STDIN)));

// Analisar a entrada JSON em um array
$productsData = (array)json_decode($jsonInput, true);

// TODO: Criar uma instância de InMemoryProductRepository

// TODO: Percorrer $productsData e salvar cada produto
// Cada item tem as chaves 'id', 'name' e 'price'

// TODO: Obter todos os produtos e imprimir a contagem total
// Format: "Total products: [count]"

// TODO: Encontrar o produto com $searchId
// Se encontrado, imprimir: "Found: [name] - $[price]" (preço formatado com 2 casas decimais)
// If not found, print: "Found: Not found"

?>