Adapterパターンは、機能の再利用の際にで用いられるデザインパターンの手法の１つです。互換性のないインターフェースを持つクラスやそれらの機能を吸収するクラス（＝アダプタ）を設けて両者を吸収する事で、既に存在しているクラスを変更する事なく新しい機能を持ったクラスを定義できます。

Adapterパターン | PHPデザインパターン

Adapter パターンは、機能の再利用の際にで用いられるデザインパターンの手法の１つです。互換性のないインターフェースを持つクラスやそれらの機能を吸収するクラス（＝アダプタ）を設けて両者を吸収する事で、既に存在しているクラスを変更する事なく新しい機能を持ったクラスを定義できます。（Wrapper（ラッパー）パターンとも呼ばれます）
アダプター、つまりは両者を連絡するという意味の通り、これまで別々に存在し使われていた機能をつなぎ合わせ、一つの処理モデルを定義する事が出来ます。そしてそれは、再利用する機能を再利用用に変更するのではなく、それらをつなぎ合わせ１つのクラスを作成する事で、従来のものを変更せずに済む事になります。
Adapter パターンには、以下２つの手法があります。
<h2 id="継承を用いる-adapter-パターン">継承を用いる Adapter パターン</h2>
アダプタで吸収する機能がサブクラスとインターフェイスの場合に用いられます。アダプタとして作成したクラスが拡張するクラスを継承し、そして取り込む一方のインターフェイスを実装します。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/118/9LITY7oRc6urpIuIQYXv.png" width="600" height="315" alt="継承を用いる Adapter パターンのクラス図"></div>
<h2 id="委譲を用いる-adapter-パターン">委譲を用いる Adapter パターン</h2>
アダプタとして作成したクラスが、拡張するクラスを直接インスタンス化し、そして取り込む一方のインターフェイスを実装します。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/118/PYJOZvJ7UjOw385AefLl.png" width="600" height="315" alt="委譲を用いる Adapter パターンのクラス図"></div>
こちらは主に、アダプタで吸収する機能のうち、拡張として吸収する側のクラスが多重継承や継承不可クラスであった場合に用いられます。
<h2 id="実装例">実装例</h2>
Adapter パターンの実装例を以下に示します。
あるところに「PHP自動車株式会社（以下、PHP自動車）」という会社がありました。人気車種「Laravel 」を主軸にたくさんの車種を世界展開していました。
「わが社の人気車種 Laravel は、ガソリンの燃焼効率を最大限にまで向上させる事で高燃費を実現しています！」
ガソリン車（Automobile）である Laravel の持つ機能は以下の通りです。
<dl class="description_setting">
<dt>App/Car/Automobile.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\gasolineEngineInterface;

class Automobile implements gasolineEngineInterface
{
 public function gasolineOutput($ratio)
 {
 return sprintf('ガソリン：%d ％', $ratio);
 }

 public function running()
 {
 echo sprintf('[出力] %s', $this->gasolineOutput(100));
 }
}
</code></pre>
</dd>
</dl>
通常のガソリン車である Laravel は、インターフェイスにガソリンでの出力を司る gasolineOutput() メソッド を兼ね備えています。
<dl class="description_setting">
<dt>App/Car/Interfaces/gasolineEngineInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car\Interfaces;

interface GasolineEngineInterface
{
 public function gasolineOutput($ratio);
}
</code></pre>
</dd>
</dl>
これらを用いて発進する事で、ガソリン出力を得る事が出来ます。
<pre><code class="hljs language-php">&#x3C;?php
use App\car\Automobile;

$automobile = new Automobile();
$automobile->running();

 => ガソリン：100 ％
</code></pre>
しかしながら、時代の流れとともに自動車産業にも環境保全の波が押し寄せてきました。
そこで PHP自動車は研究に研究を重ね、電気自動車の開発に成功しました。
「わが社の新型車 CakePHP は、電気で走るこれまでとは全く違う自動車です。これにより、環境にやさしく先進的な体験をみなさんに提供いたします！」
電気自動車（ElectricCar）である CakePHP の持つ機能は以下の通りです。
<dl class="description_setting">
<dt>App/Car/ElectricCar.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\ElectricEngineInterface;

class ElectricCar implements ElectricEngineInterface
{
 public function electricOutput($ratio)
 {
 return sprintf('電気：%d ％', $ratio);
 }

 public function running()
 {
 echo sprintf('[出力] %s', $this->electricOutput(100));
 }
}
</code></pre>
</dd>
</dl>
電気自動車なので、インターフェイスに電気での出力を司る electricOutput() メソッドを装備しています。
<dl class="description_setting">
<dt>App/Car/Interfaces/ElectricEngineInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car\Interfaces;

interface ElectricEngineInterface
{
 public function electricOutput($ratio);
}
</code></pre>
</dd>
</dl>
このポテンシャルを以て、電気出力での走行が可能になります。
<pre><code class="hljs language-php">&#x3C;?php
use App\Car\ElectricCar;

$electric_car = new ElectricCar();
$electric_car->running();

 => 電気： 100 ％
</code></pre>
電気自動車は大成功。性能もよく飛ぶように売れました。
しかし、社長には気がかりな事がありました。それは、ガソリン車である Laravel の事です。
「ううむ。。わが社の代名詞ともいうこの車を、時代の流れで衰退させるわけにはいかぬ。どうにか刷新を図りたい。」
そこで素晴らしいアイデアを考え付きました。
「そうだ、ガソリンと電気の両方を使うハイブリッド車を作ろう！ガソリン車自体はまだまだ需要はあるとはいえ、時代の流れを鑑みて、ガソリンと電気の良いところを合わせれば環境にもやさしく力強い走りを実現できる！」
PHP自動車の顔ともいうべき Laravel の新型開発が始まりました。
Laravel 新モデルの作成に際してとりまとめたメモが以下のように残っていました。
<ul>
<li>電気出力には、CakePHP に搭載されているわが社の先進的な電気出力機能を使う。</li>
<li>ガソリン車としての Laravel はまだまだこの先も独自の発展を遂げていく。だからガソリン仕様車は残した上で、ニューモデルであるハイブリッド車を作る。</li>
</ul>
従来（ガソリン）車は残したまま、それでいて電気要素も装備した新しい新車を作る。もちろん従来車がアップデートされれば新車にもそれは適用される。
この課題を受けて技術者たちは考えました。 
「ううむ。。できるだけいいとこどりをして無駄のないようにしなければいけないな。」
そこで用いたのが Adapter パターンでした。
「ガソリン Laravel を継承した新しいクラスを作り、そこに電気出力インターフェイスを装備する。こうする事でハイブリッド Laravel が出来るはずだ！」
ハイブリッド車（HybridCar）である Laravel Hybrid の持つ機能は以下の通りです。
<dl class="description_setting">
<dt>App/Car/HybridCar.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\ElectricEngineInterface;

class HybridCar extends Automobile implements ElectricEngineInterface
{
 public function electricOutput($ratio)
 {
 return sprintf('電気：%d ％', $ratio);
 }

 public function running()
 {
 // ガソリン出力
 echo sprintf('[出力] %s', $this->gasolineOutput(50));
 // 電気出力
 echo sprintf('[出力] %s', $this->electricOutput(50));
 }
}
</code></pre>
</dd>
</dl>
同車種であるガソリン車を継承し、異車種である電気自動車の電気出力インターフェイスを装備しています。
<dl class="description_setting">
<dt>App/Car/Interfaces/ElectricEngineInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car\Interfaces;

interface ElectricEngineInterface
{
 public function electricOutput($ratio);
}
</code></pre>
</dd>
</dl>
これらを用いてサブクラスでは、ハイブリッドでの動作の為の定義やオーバーライドを行い、ハイブリッド車としての新型モデル Laravel Hybrid が誕生しました。
<pre><code class="hljs language-php">&#x3C;?php
use App\Car\HybridCar;

$hybrid_car = new HybridCar();
$hybrid_car->running();

 => ガソリン： 50 ％ 電気： 50 ％
</code></pre>
ちなみにこの例は継承を用いた Adapter パターンですが、委譲を用いた手法の場合は、HybridCar クラスは以下のようになります。
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\ElectricEngineInterface;

class HybridCar implements ElectricEngineInterface
{
 protected $automobile;

 public function __construct()
 {
 $this->automobile = new Automobile();
 }

 public function electricOutput($ratio)
 {
 return sprintf('電気：%d ％', $ratio);
 }

 public function running()
 {
 // ガソリン出力
 echo sprintf('[出力] %s', $this->automobile->gasolineOutput(50));

 // 電気出力
 echo sprintf('[出力] %s', $this->electricOutput(50));
 }
}
</code></pre>
<h2 id="まとめ">まとめ</h2>
Adapter パターンを用いると、コードの重複も無くせる上に母体がアップデートすればアダプタで生成した側の機能も同時にアップデートされ、効率良く処理モデルを構築していけます。
また、１つの処理モデルを作成する際に、基となるクラスやインターフェイスは一切変更を加えなくて済むというのも大きな利点です。
ただしこの手法を使いまくると各機能の関係性が不透明になる場合も多くあるので、もし意図せず多用せざるを得ない状況になった場合は設計を見直す事が大切です。見通しの良い設計の元で計画的に用いていきましょう。

Adapter パターンは、機能の再利用の際にで用いられるデザインパターンの手法の１つです。互換性のないインターフェースを持つクラスやそれらの機能を吸収するクラス（＝アダプタ）を設けて両者を吸収する事で、既に存在しているクラスを変更する事なく新しい機能を持ったクラスを定義できます。（Wrapper（ラッパー）パターンとも呼ばれます）
アダプター、つまりは両者を連絡するという意味の通り、これまで別々に存在し使われていた機能をつなぎ合わせ、一つの処理モデルを定義する事が出来ます。そしてそれは、再利用する機能を再利用用に変更するのではなく、それらをつなぎ合わせ１つのクラスを作成する事で、従来のものを変更せずに済む事になります。
Adapter パターンには、以下２つの手法があります。
<h2 id="継承を用いる-adapter-パターン">継承を用いる Adapter パターン</h2>
アダプタで吸収する機能がサブクラスとインターフェイスの場合に用いられます。アダプタとして作成したクラスが拡張するクラスを継承し、そして取り込む一方のインターフェイスを実装します。
<div class="img_wrap"><img src="/images/posts/118/9LITY7oRc6urpIuIQYXv.png" width="600" height="315" alt="継承を用いる Adapter パターンのクラス図"></div>
<h2 id="委譲を用いる-adapter-パターン">委譲を用いる Adapter パターン</h2>
アダプタとして作成したクラスが、拡張するクラスを直接インスタンス化し、そして取り込む一方のインターフェイスを実装します。
<div class="img_wrap"><img src="/images/posts/118/PYJOZvJ7UjOw385AefLl.png" width="600" height="315" alt="委譲を用いる Adapter パターンのクラス図"></div>
こちらは主に、アダプタで吸収する機能のうち、拡張として吸収する側のクラスが多重継承や継承不可クラスであった場合に用いられます。
<h2 id="実装例">実装例</h2>
Adapter パターンの実装例を以下に示します。
あるところに「PHP自動車株式会社（以下、PHP自動車）」という会社がありました。人気車種「Laravel 」を主軸にたくさんの車種を世界展開していました。
「わが社の人気車種 Laravel は、ガソリンの燃焼効率を最大限にまで向上させる事で高燃費を実現しています！」
ガソリン車（Automobile）である Laravel の持つ機能は以下の通りです。
<dl class="description_setting">
<dt>App/Car/Automobile.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\gasolineEngineInterface;

class Automobile implements gasolineEngineInterface
{
 public function gasolineOutput($ratio)
 {
 return sprintf('ガソリン：%d ％', $ratio);
 }

 public function running()
 {
 echo sprintf('[出力] %s', $this->gasolineOutput(100));
 }
}
</code></pre>
</dd>
</dl>
通常のガソリン車である Laravel は、インターフェイスにガソリンでの出力を司る gasolineOutput() メソッド を兼ね備えています。
<dl class="description_setting">
<dt>App/Car/Interfaces/gasolineEngineInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car\Interfaces;

interface GasolineEngineInterface
{
 public function gasolineOutput($ratio);
}
</code></pre>
</dd>
</dl>
これらを用いて発進する事で、ガソリン出力を得る事が出来ます。
<pre><code class="hljs language-php">&#x3C;?php
use App\car\Automobile;

$automobile = new Automobile();
$automobile->running();

 => ガソリン：100 ％
</code></pre>
しかしながら、時代の流れとともに自動車産業にも環境保全の波が押し寄せてきました。
そこで PHP自動車は研究に研究を重ね、電気自動車の開発に成功しました。
「わが社の新型車 CakePHP は、電気で走るこれまでとは全く違う自動車です。これにより、環境にやさしく先進的な体験をみなさんに提供いたします！」
電気自動車（ElectricCar）である CakePHP の持つ機能は以下の通りです。
<dl class="description_setting">
<dt>App/Car/ElectricCar.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\ElectricEngineInterface;

class ElectricCar implements ElectricEngineInterface
{
 public function electricOutput($ratio)
 {
 return sprintf('電気：%d ％', $ratio);
 }

 public function running()
 {
 echo sprintf('[出力] %s', $this->electricOutput(100));
 }
}
</code></pre>
</dd>
</dl>
電気自動車なので、インターフェイスに電気での出力を司る electricOutput() メソッドを装備しています。
<dl class="description_setting">
<dt>App/Car/Interfaces/ElectricEngineInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car\Interfaces;

interface ElectricEngineInterface
{
 public function electricOutput($ratio);
}
</code></pre>
</dd>
</dl>
このポテンシャルを以て、電気出力での走行が可能になります。
<pre><code class="hljs language-php">&#x3C;?php
use App\Car\ElectricCar;

$electric_car = new ElectricCar();
$electric_car->running();

 => 電気： 100 ％
</code></pre>
電気自動車は大成功。性能もよく飛ぶように売れました。
しかし、社長には気がかりな事がありました。それは、ガソリン車である Laravel の事です。
「ううむ。。わが社の代名詞ともいうこの車を、時代の流れで衰退させるわけにはいかぬ。どうにか刷新を図りたい。」
そこで素晴らしいアイデアを考え付きました。
「そうだ、ガソリンと電気の両方を使うハイブリッド車を作ろう！ガソリン車自体はまだまだ需要はあるとはいえ、時代の流れを鑑みて、ガソリンと電気の良いところを合わせれば環境にもやさしく力強い走りを実現できる！」
PHP自動車の顔ともいうべき Laravel の新型開発が始まりました。
Laravel 新モデルの作成に際してとりまとめたメモが以下のように残っていました。
<ul>
<li>電気出力には、CakePHP に搭載されているわが社の先進的な電気出力機能を使う。</li>
<li>ガソリン車としての Laravel はまだまだこの先も独自の発展を遂げていく。だからガソリン仕様車は残した上で、ニューモデルであるハイブリッド車を作る。</li>
</ul>
従来（ガソリン）車は残したまま、それでいて電気要素も装備した新しい新車を作る。もちろん従来車がアップデートされれば新車にもそれは適用される。
この課題を受けて技術者たちは考えました。 
「ううむ。。できるだけいいとこどりをして無駄のないようにしなければいけないな。」
そこで用いたのが Adapter パターンでした。
「ガソリン Laravel を継承した新しいクラスを作り、そこに電気出力インターフェイスを装備する。こうする事でハイブリッド Laravel が出来るはずだ！」
ハイブリッド車（HybridCar）である Laravel Hybrid の持つ機能は以下の通りです。
<dl class="description_setting">
<dt>App/Car/HybridCar.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\ElectricEngineInterface;

class HybridCar extends Automobile implements ElectricEngineInterface
{
 public function electricOutput($ratio)
 {
 return sprintf('電気：%d ％', $ratio);
 }

 public function running()
 {
 // ガソリン出力
 echo sprintf('[出力] %s', $this->gasolineOutput(50));
 // 電気出力
 echo sprintf('[出力] %s', $this->electricOutput(50));
 }
}
</code></pre>
</dd>
</dl>
同車種であるガソリン車を継承し、異車種である電気自動車の電気出力インターフェイスを装備しています。
<dl class="description_setting">
<dt>App/Car/Interfaces/ElectricEngineInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car\Interfaces;

interface ElectricEngineInterface
{
 public function electricOutput($ratio);
}
</code></pre>
</dd>
</dl>
これらを用いてサブクラスでは、ハイブリッドでの動作の為の定義やオーバーライドを行い、ハイブリッド車としての新型モデル Laravel Hybrid が誕生しました。
<pre><code class="hljs language-php">&#x3C;?php
use App\Car\HybridCar;

$hybrid_car = new HybridCar();
$hybrid_car->running();

 => ガソリン： 50 ％ 電気： 50 ％
</code></pre>
ちなみにこの例は継承を用いた Adapter パターンですが、委譲を用いた手法の場合は、HybridCar クラスは以下のようになります。
<pre><code class="hljs language-php">&#x3C;?php
namespace App\Car;

use App\Car\Interfaces\ElectricEngineInterface;

class HybridCar implements ElectricEngineInterface
{
 protected $automobile;

 public function __construct()
 {
 $this->automobile = new Automobile();
 }

 public function electricOutput($ratio)
 {
 return sprintf('電気：%d ％', $ratio);
 }

 public function running()
 {
 // ガソリン出力
 echo sprintf('[出力] %s', $this->automobile->gasolineOutput(50));

 // 電気出力
 echo sprintf('[出力] %s', $this->electricOutput(50));
 }
}
</code></pre>
<h2 id="まとめ">まとめ</h2>
Adapter パターンを用いると、コードの重複も無くせる上に母体がアップデートすればアダプタで生成した側の機能も同時にアップデートされ、効率良く処理モデルを構築していけます。
また、１つの処理モデルを作成する際に、基となるクラスやインターフェイスは一切変更を加えなくて済むというのも大きな利点です。
ただしこの手法を使いまくると各機能の関係性が不透明になる場合も多くあるので、もし意図せず多用せざるを得ない状況になった場合は設計を見直す事が大切です。見通しの良い設計の元で計画的に用いていきましょう。

Author