develop#工厂方法模式

Author: chenchangqin

DesignerPatterns/AbstractFactory/Readme.md

@@ -8,4 +8,4 @@
 
 这种机制让替换平台变得简单，因为抽象工厂的具体实现类只有在实例化的时候才出现，如果要替换的话只需要在实例化的时候指定具体实现类即可。
 ## 4、UML类图
-![Factory-UML.png](/static/images/Factory-UML.png)
+![Factory-UML.png](/static/images/Abstract-Factory-UML.png)

DesignerPatterns/FactoryMethod/FactoryMethod.php

@@ -0,0 +1,42 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:44
+ */
+
+namespace DesignerPatterns\FactoryMethod;
+
+/**
+ * 工厂方法抽象类
+ */
+abstract class FactoryMethod
+{
+    const CHEAP = 1;
+    const FAST = 2;
+
+    /**
+     * 子类必须实现该方法
+     *
+     * @param string $type a generic type
+     *
+     * @return VehicleInterface a new vehicle
+     */
+    abstract protected function createVehicle($type);
+
+    /**
+     * 创建新的车辆
+     *
+     * @param int $type
+     *
+     * @return VehicleInterface a new vehicle
+     */
+    public function create($type)
+    {
+        $obj = $this->createVehicle($type);
+        $obj->setColor("#f00");
+
+        return $obj;
+    }
+}

DesignerPatterns/FactoryMethod/Ferrari.php

@@ -0,0 +1,28 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:48
+ */
+
+namespace DesignerPatterns\FactoryMethod;
+
+/**
+ * Ferrari（法拉利）
+ */
+class Ferrari implements VehicleInterface
+{
+    /**
+     * @var string
+     */
+    protected $color;
+
+    /**
+     * @param string $rgb
+     */
+    public function setColor($rgb)
+    {
+        $this->color = $rgb;
+    }
+}

DesignerPatterns/FactoryMethod/GermanFactory.php

@@ -0,0 +1,36 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:45
+ */
+
+namespace DesignerPatterns\FactoryMethod;
+
+/**
+ * GermanFactory是德国的造车厂
+ */
+class GermanFactory extends FactoryMethod
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected function createVehicle($type)
+    {
+        switch ($type) {
+            case parent::CHEAP:
+                return new Lamborghini();
+                break;
+            case parent::FAST:
+                $obj = new Porsche();
+                //因为我们已经知道是什么对象所以可以调用具体方法
+                $obj->addTuningAMG();
+
+                return $obj;
+                break;
+            default:
+                throw new \InvalidArgumentException("$type is not a valid vehicle");
+        }
+    }
+}

DesignerPatterns/FactoryMethod/ItalianFactory.php

@@ -0,0 +1,32 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:44
+ */
+
+namespace DesignerPatterns\FactoryMethod;
+
+/**
+ * ItalianFactory是意大利的造车厂
+ */
+class ItalianFactory extends FactoryMethod
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected function createVehicle($type)
+    {
+        switch ($type) {
+            case parent::CHEAP:
+                return new Lamborghini();
+                break;
+            case parent::FAST:
+                return new Ferrari();
+                break;
+            default:
+                throw new \InvalidArgumentException("$type is not a valid vehicle");
+        }
+    }
+}

DesignerPatterns/FactoryMethod/Lamborghini.php

@@ -0,0 +1,30 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:46
+ */
+
+namespace DesignerPatterns\FactoryMethod;
+
+/**
+ * Porsche（保时捷）
+ */
+class Lamborghini implements VehicleInterface
+{
+    /**
+     * @var string
+     */
+    protected $color;
+
+    /**
+     * 设置自行车的颜色
+     *
+     * @param string $rgb
+     */
+    public function setColor($rgb)
+    {
+        $this->color = $rgb;
+    }
+}

DesignerPatterns/FactoryMethod/Porsche.php

@@ -0,0 +1,35 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:46
+ */
+
+namespace DesignerPatterns\FactoryMethod;
+/**
+ * Porsche（保时捷）
+ */
+
+class Porsche implements VehicleInterface
+{
+    /**
+     * @var string
+     */
+    protected $color;
+
+    /**
+     * @param string $rgb
+     */
+    public function setColor($rgb)
+    {
+        $this->color = $rgb;
+    }
+
+    /**
+     * 尽管只有奔驰汽车挂有AMG品牌，这里我们提供一个空方法仅作代码示例
+     */
+    public function addTuningAMG()
+    {
+    }
+}

DesignerPatterns/FactoryMethod/Readme.md

@@ -0,0 +1,14 @@
+# PHP 设计模式系列 —— 工厂方法模式（Factory Method）
+## 1、模式定义
+定义一个创建对象的接口，但是让子类去实例化具体类。工厂方法模式让类的实例化延迟到子类中。
+
+## 2、问题引出
+框架需要为多个应用提供标准化的架构模型，同时也要允许独立应用定义自己的域对象并对其进行实例化。
+
+## 3、解决办法
+工厂方法以模板方法的方式创建对象来解决上述问题。父类定义所有标准通用行为，然后将创建细节放到子类中实现并输出给客户端。
+
+人们通常使用工厂模式作为创建对象的标准方式，但是在这些情况下不必使用工厂方法：实例化的类永远不会改变；或者实例化发生在子类可以轻易覆盖的操作中（比如初始化）。
+
+## 4、UML类图
+![Factory-Method-UML.png](/static/images/Factory-Method-UML.png)

DesignerPatterns/FactoryMethod/VehicleInterface.php

@@ -0,0 +1,22 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:46
+ */
+
+namespace DesignerPatterns\FactoryMethod;
+
+/**
+ * VehicleInterface是车辆接口
+ */
+interface VehicleInterface
+{
+    /**
+     * 设置车的颜色
+     *
+     * @param string $rgb
+     */
+    public function setColor($rgb);
+}

Tests/FactoryMethodTest/FactoryMethodTest.php

@@ -0,0 +1,55 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: chenchangqin
+ * Date: 2018/12/19
+ * Time: 16:49
+ */
+
+namespace Tests\FactoryMethodTest;
+
+use DesignerPatterns\FactoryMethod\FactoryMethod;
+use DesignerPatterns\FactoryMethod\GermanFactory;
+use DesignerPatterns\FactoryMethod\ItalianFactory;
+
+class FactoryMethodTest extends \PHPUnit_Framework_TestCase
+{
+    protected $type = array(
+        FactoryMethod::CHEAP,
+        FactoryMethod::FAST
+    );
+
+    public function getShop()
+    {
+        return array(
+            array(new GermanFactory()),
+            array(new ItalianFactory())
+        );
+    }
+
+    /**
+     * @dataProvider getShop
+     */
+    public function testCreation(FactoryMethod $shop)
+    {
+        // 该方法扮演客户端角色，我们不关心什么工厂，我们只知道可以可以用它来造车
+        foreach ($this->type as $oneType) {
+            $vehicle = $shop->create($oneType);
+            /**
+             * assertInstanceOf($expected, $actual[, $message = ''])
+             * $actual 不是 $expected 的实例时报告错误，错误讯息由 $message 指定。
+             */
+            $this->assertInstanceOf('DesignerPatterns\FactoryMethod\VehicleInterface', $vehicle);
+        }
+    }
+
+    /**
+     * @dataProvider getShop
+     * @expectedException \InvalidArgumentException
+     * @expectedExceptionMessage spaceship is not a valid vehicle
+     */
+    public function testUnknownType(FactoryMethod $shop)
+    {
+        $shop->create('spaceship');
+    }
+}