Pattern Factory

Fa parte della sezione Programmazione orientata agli oggetti del percorso PHP di Coddy. Lezione 72 di 91.

Il Factory Pattern è un pattern di progettazione creazionale che delega la creazione degli oggetti a una classe o a un metodo separato. Invece di usare direttamente new in tutto il codice, chiedi a una factory di creare gli oggetti per te.

Questo modello è particolarmente utile quando hai più classi correlate che condividono un'interfaccia comune e vuoi decidere quale istanziare in base a una condizione. Considera un sistema di notifiche che può inviare messaggi tramite canali diversi:

<?php
interface Notification {
    public function send(string $message): string;
}

class EmailNotification implements Notification {
    public function send(string $message): string {
        return "Email: $message";
    }
}

class SmsNotification implements Notification {
    public function send(string $message): string {
        return "SMS: $message";
    }
}

Senza una factory, spargeresti istruzioni if e chiamate new ovunque. La factory centralizza questa logica:

<?php
class NotificationFactory {
    public static function create(string $type): Notification {
        return match($type) {
            'email' => new EmailNotification(),
            'sms' => new SmsNotification(),
            default => throw new InvalidArgumentException("Unknown type: $type")
        };
    }
}

$notification = NotificationFactory::create('email');
echo $notification->send('Hello!');

Output:

Email: Hello!

Il vantaggio principale è che il tuo codice dipende dall’interfaccia Notification, non da classi concrete. Se in seguito aggiungi una classe PushNotification, aggiorni solo la factory. Tutto il codice che usa la factory ottiene automaticamente accesso al nuovo tipo senza modifiche.

Sfida

Facile

Costruiamo un sistema per generare documenti usando il Factory Pattern. Diversi tipi di documenti (PDF, HTML, testo semplice) condividono un'interfaccia comune, ma producono output diversi: uno scenario perfetto per centralizzare la creazione degli oggetti in una factory.

Organizzerai il codice in quattro file:

Document.php: crea un'interfaccia Document che definisce il contratto che tutti i tipi di documento devono rispettare. Dovrebbe avere un unico metodo render(string $content): string che accetta il contenuto e restituisce il documento formattato.
Documents.php: includi l'interfaccia Document e crea tre classi che la implementano:
- PdfDocument: il suo metodo render() restituisce "PDF: [content]"
- HtmlDocument: il suo metodo render() restituisce "<html>[content]</html>"
- TextDocument: il suo metodo render() restituisce "TXT: [content]"
DocumentFactory.php: includi il file Documents e crea una classe DocumentFactory con un metodo statico create(string $type): Document. Questo metodo dovrebbe usare match per restituire l'oggetto documento appropriato in base al tipo:
- "pdf" restituisce una nuova istanza di PdfDocument
- "html" restituisce una nuova istanza di HtmlDocument
- "text" restituisce una nuova istanza di TextDocument
- Qualsiasi altro tipo dovrebbe generare un'InvalidArgumentException con il messaggio "Unknown document type: [type]"
main.php: includi il file DocumentFactory. Riceverai due input: un tipo di documento e il contenuto da renderizzare.
Usa la factory per creare il tipo di documento appropriato, poi chiama il suo metodo render() con il contenuto e stampa il risultato.

Su una nuova riga, stampa "Factory benefit: Adding new types only requires updating the factory" per evidenziare il valore di questo pattern.

Il Factory Pattern mantiene flessibile il tuo codice: quando in futuro dovrai aggiungere un MarkdownDocument, aggiornerai solo la factory, mentre tutto il codice esistente continuerà a funzionare senza modifiche.

Provalo tu

<?php
require_once 'DocumentFactory.php';

// Leggi l'input
$type = trim(fgets(STDIN));
$content = trim(fgets(STDIN));

// TODO: Usa DocumentFactory per creare il tipo di documento appropriato
// TODO: Chiama il metodo render() con il contenuto e stampa il risultato
// TODO: Su una nuova riga, stampa "Factory benefit: Adding new types only requires updating the factory"

?>