Bridgeパターン - PHPデザインパターン

実装例

今回はあるアプリケーションがデータを取得し表示する例で実装していきます。

このアプリケーションでは、あるページで連続したデータを持つ配列を取得し表示していますが、表示箇所が不規則な為、一つずつ、任意の場所へ表示する必要がありました。。ですがこの度、別の箇所で同じデータを用いてループで表示する処理が必要になりました。

まずは、データを取り出すクラスから作成します。インターフェイスを定義します。今回はデモなのでデータベースからではなくjsonファイルをデータソースとし、データを取得します。

App/Bridge/Interfaces/FileDataManageInterface.php

<?php

namespace App\Bridge\Interfaces;

interface FileDataManageInterface
{
    public function read();
    public function display();
    public function getTotalCount();
    public function getPointer();
}

それぞれ、ファイルを読み込む、表示する、データ個数、現在のポインタ位置を返却するメソッドを定義しています。このインターフェイスは、クラス図でいうところのImplementorに当たります。

次に、このインターフェイスを実装し具象クラスを作成します。

App/Bridge/FileDataManage.php

<?php

namespace App\Bridge;

use App\Bridge\Interfaces\FileDataManageInterface;

class FileDataManage implements FileDataManageInterface
{
    private $json_path;
    private $data;
    private $data_total = 0;
    private $pointer = 0;

    public function __construct($json)
    {
        $this->json_path = $json;
    }

    public function read()
    {
        $this->data = json_decode(file_get_contents($this->json_path));
        $this->data_total = count($this->data);
    }

    public function display()
    {
        echo sprintf(
            "id:%s / name:%s / category:%s<br>",
            $this->data[$this->pointer]->id,
            $this->data[$this->pointer]->name,
            $this->data[$this->pointer]->category
        );
        $this->pointer++;
    }

    public function getTotalCount()
    {
        return $this->data_total;
    }

    public function getPointer()
    {
        return $this->pointer;
    }

}

ここでの機能は最も基本的なものとなります。クラス図で言うところのConcreteImplementorです。そしてここまでで、データを取得する側、つまりはA地点の完成です。

次は、データを表示する側、B地点を作成します。まずは初期に実装していた、一つずつ、任意の場所へ表示するクラスです。

App/Bridge/Output.php

<?php

namespace App\Bridge;

class Output
{
    protected $data_manager;

    public function __construct(FileDataManage $dataManage)
    {
        $this->data_manager = $dataManage;
    }

    public function read()
    {
        $this->data_manager->read();
    }
    public function display()
    {
        $this->data_manager->display();
    }
}

ポイントはデータ周りを担当するクラスを継承ではなく委譲で受け取っている点です。ここがいわゆる「橋渡し」に部分になりますが、この例ではこうすることで、データの提供側と表示側が完全に分離しています。そして、コストラクタで受け取ったオブジェクトを利用し、読み込みと表示メソッドをそのまま実行するように定義しています。

次に、データの表示方法が増えた部分、ループでの表示処理が必要な場面が出てきた部分です。

App/Bridge/OutputAuto.php

<?php

namespace App\Bridge;

use App\Bridge\Output;

class OutputAuto extends Output
{
    public function __construct(FileDataManage $dataManage) {
        parent::__construct($dataManage);
    }

    public function autoDisplay()
    {
        while ($this->data_manager->getPointer() !== $this->data_manager->getTotalCount()) {
            $this->data_manager->display();
        }
    }
}

初代のクラスを継承した上で、今回必要な処理を定義しています。 ここでも、データ取得係のクラスは委譲で受け取っています。

最後に、これらを使って実際に表示を行います。

index.php

<?php
use App\Bridge\FileDataManage;
use App\Bridge\Output;
use App\Bridge\OutputAuto;

$json_path = 'App/Files/frameworks.json';

$manual = new Output(new FileDataManage($json_path));
$auto = new OutputAuto(new FileDataManage($json_path));

$manual->read();
$auto->read();

echo '<h2>１つずつ表示</h2>';
$manual->display();
$manual->display();
$manual->display();

echo '<h2>全て表示</h2>';
$auto->autoDisplay();

結果は以下のようになります。

まとめ

実装例は冒頭で紹介した例よりはかなり簡易的だったのでBridgeパターンによる恩恵はあまり大きくなかったですが、それでもここから規模を大きくしていくにつれてこのパターンで良かったと思えるでしょう。

例えばこうしておくことで、データの取得をjsonからデータベースに切り替える際も容易です。なぜなら橋渡しのおかげで、役割間の依存が無いからです。

このように、Bridgeパターンを用いると提供側と表示側それぞれで拡張を容易に行えるようになります。何かを追加や拡張する際にどこかにも余計にクラスを作成したりする必要がなくなるので、アプリケーションの規模が大きくなればなるほどその恩恵に肖る事が出来ます。コードの重複も防げます。

とはいえ、Bridgeパターンというデザインパターンの１つはそれはそれとして、クラス設計時にはこうした構造に関してきちんと計画して実装したいものです。それを気づかせてくれるのも、デザインパターンならではです。パターンだけあって、JavaだろうがPHPだろうが、きちんとはまるあたりが先人の知恵とは素晴らしい。