# Design patterns: Template Method

> Template Method pattern con esempi in PHP

- URL: https://mautoblog.com/posts/design-patterns/template-method/
- Lingua: it
- Pubblicato: 2024-09-27
- Aggiornato: 2026-10-14
- Autore: Mauto
- Categorie: Sviluppo Software, Tecnologia
- Tags: Architettura Software, Best Practices, PHP
- Guida: Design Patterns (parte 23)
- Traduzione (en): https://mautoblog.com/en/posts/design-patterns/template-method/

---
Il **Template Method** è un pattern comportamentale che definisce la struttura di un algoritmo all'interno di un metodo, lasciando alle sottoclassi la possibilità di implementare parti specifiche dell'algoritmo senza modificarne la struttura globale.
Questo pattern permette di riutilizzare il codice e favorire una chiara separazione tra ciò che è invariabile e ciò che è variabile all'interno dell'algoritmo.

## Punti di Forza
1. **Riutilizzo del codice**: La struttura generale dell'algoritmo viene definita una volta sola nella classe base, favorendo il riutilizzo del codice comune.
2. **Definizione flessibile degli algoritmi**: Le sottoclassi possono modificare solo le parti specifiche dell'algoritmo, mantenendo invariata la sequenza generale.
3. **Prevenzione della duplicazione**: Riduce la duplicazione del codice, perché la logica comune è collocata in un'unica classe base.
4. **Controllo del flusso dell'algoritmo**: La classe base mantiene il controllo sull'esecuzione dell'algoritmo, rendendo difficile per le sottoclassi alterare l'ordine delle operazioni.
5. **Chiarezza strutturale**: Permette una chiara suddivisione tra comportamento generico (classe base) e comportamento specifico (sottoclassi).

## Caso d'uso: Procedura d'ordine online
Immagina di avere un sistema per gestire ordini online.
Il processo di ordinazione segue delle fasi comuni: **selezionare il prodotto**, **inserire i dettagli di spedizione** e **processare il pagamento**.
Tuttavia, il metodo di pagamento può variare tra **carta di credito** e **PayPal**.

### Codice PHP
```php
// Classe astratta che definisce il template method
abstract class OrderProcessTemplate {
    // Template method che definisce l'algoritmo (final: le sottoclassi non possono cambiarne la sequenza)
    final public function processOrder() {
        $this->selectProduct();
        $this->addShippingDetails();
        $this->processPayment();
        $this->shipOrder();
    }

    // Metodo comune per selezionare il prodotto, uguale per tutte le sottoclassi
    protected function selectProduct() {
        echo "Prodotto selezionato.\n";
    }

    // Metodo obbligatorio da implementare nelle sottoclassi
    abstract protected function processPayment();

    // Metodo final per aggiungere i dettagli di spedizione, invariabile tra le sottoclassi
    final protected function addShippingDetails() {
        echo "Aggiunti i dettagli di spedizione.\n";
    }

    // Metodo final per spedire l'ordine, invariabile tra le sottoclassi
    final protected function shipOrder() {
        echo "Ordine spedito.\n";
    }
}

// Implementazione concreta per un ordine pagato con Carta di Credito
class CreditCardOrder extends OrderProcessTemplate {
    protected function processPayment() {
        echo "Pagamento effettuato con Carta di Credito.\n";
    }
}

// Implementazione concreta per un ordine pagato con PayPal
class PayPalOrder extends OrderProcessTemplate {
    protected function processPayment() {
        echo "Pagamento effettuato con PayPal.\n";
    }
}

// Esempio d'uso
$order1 = new CreditCardOrder();
$order1->processOrder();  // Processo di ordinazione con Carta di Credito

echo "\n";

$order2 = new PayPalOrder();
$order2->processOrder();  // Processo di ordinazione con PayPal
```

## Spiegazione
- **Classe OrderProcessTemplate**: Definisce il Template Method **processOrder()**, dichiarato `final`, che contiene la sequenza di operazioni comuni a tutte le sottoclassi. Il metodo **selectProduct()** è implementato una sola volta nella classe base, mentre **processPayment()** è definito come astratto, lasciando alle sottoclassi il compito di implementarlo.
- Metodi Invariabili: Metodi come **addShippingDetails()** e **shipOrder()** sono comuni a tutte le sottoclassi e, essendo dichiarati `final`, non possono essere modificati.
- Sottoclassi (**CreditCardOrder**, **PayPalOrder**): Implementano solo la parte specifica dell'algoritmo, cioè il metodo di pagamento.
- Uso del **Template Method**: Il metodo **processOrder()** segue la sequenza predefinita, ma le parti variabili vengono delegate alle sottoclassi.

## Conclusione
Il **Template Method Pattern** permette di definire la struttura di un algoritmo nella classe base e delegare alle sottoclassi l'implementazione dei dettagli specifici.
Questo approccio rende il codice più modulare, riutilizzabile e facilmente estensibile.

[TORNA ALLA GUIDA](/posts/design-patterns/)
