TemplateMethodパターンをPHPで書いてみた

# TemplateMethodパターンとは？

このパターンの役割は、**重複した実装の洗練・整理**です。
流れは一緒だけれども、内部の処理が違う処理においてそれぞれの処理を分けることが出来ます。

なので、使い所としては、複数種類のフォーマットで出力をするとき(.txt, .html, .csvなど)などに使えます。

* AbstractClass : 処理の枠組みを定義するクラス。このクラスの中に、枠組みを決める**TemplateMethod**が存在しています。
* ConcreteMethod : AbstractClassを継承するサブクラス。Abstractで定義された抽象メソッドの中身を実装しています。

今回は、[こちらの本](https://www.amazon.co.jp/Head-First%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3-%E2%80%95%E9%A0%AD%E3%81%A8%E3%81%8B%E3%82%89%E3%81%A0%E3%81%A7%E8%A6%9A%E3%81%88%E3%82%8B%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3%E3%81%AE%E5%9F%BA%E6%9C%AC-Eric-Freeman/dp/4873112494)のに書かれているコードを参考に作成しました。
こちらはJavaで書かれていますので、それをPHPに書き直してみました。

# TemplateMethodパターン適用前

今回は、例として**コーヒーと紅茶を淹れるプログラム**を作ります。

テンプレートメソッドパターンを適用させる前に、一度そのままコードを書いてみましょう。

```PHP
<?php
class Coffee {
    public function describeBeverage() {
        echo "--------------------------------\n";
        echo 'コーヒーを作ります。\n';
    }
    
    public function boilWater() {
        echo'お湯を沸かします。\n';
    } 
    
    public function brew() {
        echo 'コーヒー豆を挽き、ドリップします。\n';
    }
    
    public function pourInCup() {
        echo 'カップに注ぎます。\n';
    }
    
    public function addContents() {
        echo '砂糖とミルクを足します。\n';
    }
    
    public function makeBeverage() {
        $this->describeBeverage();
        $this->boilWater();
        $this->brew();
        $this->pourInCup();
        $this->addContents();
    }
}
```

```PHP
<?php
class Tea {
    public function describeBeverage() {
        echo "--------------------------------\n";
        echo "紅茶を作ります。\n";
    }
    
    public function boilWater() {
        echo "お湯を沸かします。\n";
    } 
    
    public function brew() {
        echo "ティーバッグを浸します。\n";
    }
    
    public function pourInCup() {
        echo "カップに注ぎます。\n";
    }
    
    public function addContents() {
        echo "レモンを足します。\n";
    }
    
    public function makeBeverage() {
        $this->describeBeverage();
        $this->boilWater();
        $this->brew();
        $this->pourInCup();
        $this->addContents();
    }
}
```

```PHP
<?php
require_once 'Coffee.php';
require_once 'Tea.php';

$coffee = new Coffee();
$tea    = new Tea();

$coffee->makeBeverage();
$tea->makeBeverage();
```

```
--------------------------------
【コーヒーを作ります】
お湯を沸かします
コーヒー豆を挽き、ドリップします
カップに注ぎます
砂糖とミルクを足します
--------------------------------
【紅茶を作ります】
お湯を沸かします
ティーパックを浸します
カップに注ぎます
レモンを足します
```

出来ましたか？確かに動いていますね！では、なぜテンプレートメソッドを使う必要があるのでしょうか？

CoffeeクラスとTeaクラス、よく見ると同じ処理をそれぞれで書いていますね。
少なくとも```boilWater()```と```pourInCup()```は全く同じことをやっています。
他に飲み物が増えた時、全てのクラスに同じ処理を書くのはしんどいですよね…そこで、これらの共通する処理を**枠組み**として定義するのがテンプレートメソッドパターンです！！！！！

まず、共通する処理を定義する抽象クラスを作成しましょう。
ここでは、各クラスの共通処理をメソッドとして定義し、クラスによって異なる処理を**抽象メソッド**として定義します。
これを行うことによって、サブクラスはクラス独自の処理(今回の場合だと、```brew()```と```addContents()```)だけを記述するだけで良くなります。

# TemplateMethodパターン適用後

```php
<?php
abstract class CaffeineBeverage {

    /**
     *  各クラスの共通の処理
     */
    public function describeBeverage($beverage_name) {
        echo "--------------------------------\n";
        echo "【" . $beverage_name . "を作ります】\n";
    }

    public function boilWater() {
        echo "お湯を沸かします\n";
    }

    public function pourInCup() {
        echo "カップに注ぎます\n";
    }


    /**
     *  各クラスによって異なる処理。抽象クラスとして定義
     *  中身はサブクラスで実装してもらう
     */
    abstract protected function brew();

    abstract protected function addContents();


    /**
     *  TemplateMethod
     */
    public function makeBeverage($beverage_name) {
        //一連の動作を定義
        $this->describeBeverage($beverage_name);
        $this->boilWater();
        $this->brew();
        $this->pourInCup();  
        $this->addContents();
    }
}
```

そして、この抽象クラスを継承したサブクラス(CoffeeクラスとTeaクラス)は、それぞれ独自の処理を記述するだけです。

```php
<?php
require_once 'CaffeineBeverage.php';

class Coffee extends CaffeineBeverage {
    //それぞれのクラス独自の処理のみを実装する
    protected function brew() {
        echo "コーヒー豆を挽き、ドリップします\n";
    }

    protected function addContents() {
        echo "砂糖とミルクを足します\n";
    }
}
```

```php
<?php
require_once 'CaffeineBeverage.php';

class Tea extends CaffeineBeverage {
    //それぞれのクラス独自の処理のみを実装する
    protected function brew() {
        echo "ティーバッグを浸します\n";
    }

    protected function addContents() {
        echo "レモンを足します\n";
    }
}
```

どうでしょう？テンプレートメソッドを適用させたことによって、CoffeeクラスとTeaクラスがだいぶスッキリして見えませんか？
飲み物が増えたとしても、```CaffeineBeverage```クラスを継承して独自の処理だけ付け足せば良いので、とても楽ですね。
ただ、作り方が全く違ってたり、独自のステップ(例えば30分蒸らすとか)がある場合は、テンプレートメソッドの管轄外から外れてしまうので出来ません。

# 参考書籍

[Head Firstデザインパターン ―頭とからだで覚えるデザインパターンの基本](https://www.amazon.co.jp/Head-First%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3-%E2%80%95%E9%A0%AD%E3%81%A8%E3%81%8B%E3%82%89%E3%81%A0%E3%81%A7%E8%A6%9A%E3%81%88%E3%82%8B%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3%E3%81%AE%E5%9F%BA%E6%9C%AC-Eric-Freeman/dp/4873112494)