From 4f46d28e290cf25f58b53bfb63ab1cc3a3d845f4 Mon Sep 17 00:00:00 2001
From: Trismegiste <florent.g@allopneus.com>
Date: Sun, 12 May 2013 12:30:42 +0200
Subject: [PATCH 1/2] a builder

---
 Builder/BikeBuilder.php   | 43 ++++++++++++++++++++++++++++++++++++
 Builder/Builder.php       | 33 ++++++++++++++++++++++++++++
 Builder/CarBuilder.php    | 46 +++++++++++++++++++++++++++++++++++++++
 Builder/Director.php      | 32 +++++++++++++++++++++++++++
 Builder/Parts/Bike.php    | 15 +++++++++++++
 Builder/Parts/Car.php     | 15 +++++++++++++
 Builder/Parts/Door.php    |  8 +++++++
 Builder/Parts/Engine.php  |  8 +++++++
 Builder/Parts/Vehicle.php | 22 +++++++++++++++++++
 Builder/Parts/Wheel.php   |  8 +++++++
 10 files changed, 230 insertions(+)
 create mode 100644 Builder/BikeBuilder.php
 create mode 100644 Builder/Builder.php
 create mode 100644 Builder/CarBuilder.php
 create mode 100644 Builder/Director.php
 create mode 100644 Builder/Parts/Bike.php
 create mode 100644 Builder/Parts/Car.php
 create mode 100644 Builder/Parts/Door.php
 create mode 100644 Builder/Parts/Engine.php
 create mode 100644 Builder/Parts/Vehicle.php
 create mode 100644 Builder/Parts/Wheel.php

diff --git a/Builder/BikeBuilder.php b/Builder/BikeBuilder.php
new file mode 100644
index 0000000..bb63fdf
--- /dev/null
+++ b/Builder/BikeBuilder.php
@@ -0,0 +1,43 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Builder;
+
+/**
+ * BikeBuilder builds bike
+ */
+class BikeBuilder implements Builder
+{
+
+    protected $bike;
+
+    public function addDoors()
+    {
+        
+    }
+
+    public function addEngine()
+    {
+        $this->bike->setPart('engine', new Parts\Engine());
+    }
+
+    public function addWheel()
+    {
+        $this->bike->setPart('forwardWheel', new Parts\Wheel());
+        $this->bike->setPart('rearWheel', new Parts\Wheel());
+    }
+
+    public function createVehicle()
+    {
+        $this->bike = new Parts\Bike();
+    }
+
+    public function getVehicle()
+    {
+        return $this->bike;
+    }
+
+}
\ No newline at end of file
diff --git a/Builder/Builder.php b/Builder/Builder.php
new file mode 100644
index 0000000..a696936
--- /dev/null
+++ b/Builder/Builder.php
@@ -0,0 +1,33 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Builder;
+
+/**
+ * Builder is an interface that build parts of a complex object.
+ * 
+ * Sometime, if the builder has a better knowledge of what it builds, this 
+ * interface could be an abstract class with default methods (aka adapter)
+ * 
+ * If you have a complex inheritance tree for vehicles, it is logical to have
+ * a complex inheritance tree for builders too.
+ * 
+ * Note: Builders have often a fluent interface, see the mock builder of
+ * PHPUnit for example.
+ */
+interface Builder
+{
+
+    function createVehicle();
+
+    function addWheel();
+
+    function addEngine();
+
+    function addDoors();
+
+    function getVehicle();
+}
\ No newline at end of file
diff --git a/Builder/CarBuilder.php b/Builder/CarBuilder.php
new file mode 100644
index 0000000..867c038
--- /dev/null
+++ b/Builder/CarBuilder.php
@@ -0,0 +1,46 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Builder;
+
+/**
+ * CarBuilder builds car
+ */
+class CarBuilder implements Builder
+{
+
+    protected $car;
+
+    public function addDoors()
+    {
+        $this->car->setPart('rightdoor', new Parts\Door());
+        $this->car->setPart('leftDoor', new Parts\Door());
+    }
+
+    public function addEngine()
+    {
+        $this->car->setPart('engine', new Parts\Engine());
+    }
+
+    public function addWheel()
+    {
+        $this->car->setPart('wheelLF', new Parts\Wheel());
+        $this->car->setPart('wheelRF', new Parts\Wheel());
+        $this->car->setPart('wheelLR', new Parts\Wheel());
+        $this->car->setPart('wheelRR', new Parts\Wheel());
+    }
+
+    public function createVehicle()
+    {
+        $this->car = new Parts\Car();
+    }
+
+    public function getVehicle()
+    {
+        return $this->car;
+    }
+
+}
\ No newline at end of file
diff --git a/Builder/Director.php b/Builder/Director.php
new file mode 100644
index 0000000..7a55a0d
--- /dev/null
+++ b/Builder/Director.php
@@ -0,0 +1,32 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Builder;
+
+/**
+ * Director is part of the builder pattern. It knows the interface of the builder
+ * and build a complex object with the help of the builder. 
+ * If you make it abstract, this becomes a "meta-factory-method" very powerfull.
+ * 
+ * You can also inject many builders instead of one to build more complex objects
+ */
+class Director
+{
+
+    /**
+     * The director don't know 'bout concrete part
+     */
+    public function build(Builder $builder)
+    {
+        $builder->createVehicle();
+        $builder->addDoors();
+        $builder->addEngine();
+        $builder->addWheel();
+
+        return $builder->getVehicle();
+    }
+
+}
\ No newline at end of file
diff --git a/Builder/Parts/Bike.php b/Builder/Parts/Bike.php
new file mode 100644
index 0000000..b10ad1f
--- /dev/null
+++ b/Builder/Parts/Bike.php
@@ -0,0 +1,15 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Builder\Parts;
+
+/**
+ * Bike is a bike
+ */
+class Bike extends Vehicle
+{
+    
+}
\ No newline at end of file
diff --git a/Builder/Parts/Car.php b/Builder/Parts/Car.php
new file mode 100644
index 0000000..1d7a05c
--- /dev/null
+++ b/Builder/Parts/Car.php
@@ -0,0 +1,15 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Builder\Parts;
+
+/**
+ * Car is a car
+ */
+class Car extends Vehicle
+{
+    
+}
\ No newline at end of file
diff --git a/Builder/Parts/Door.php b/Builder/Parts/Door.php
new file mode 100644
index 0000000..cbe9b63
--- /dev/null
+++ b/Builder/Parts/Door.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DesignPatterns\Builder\Parts;
+
+class Door
+{
+    
+}
\ No newline at end of file
diff --git a/Builder/Parts/Engine.php b/Builder/Parts/Engine.php
new file mode 100644
index 0000000..2231026
--- /dev/null
+++ b/Builder/Parts/Engine.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DesignPatterns\Builder\Parts;
+
+class Engine
+{
+    
+}
\ No newline at end of file
diff --git a/Builder/Parts/Vehicle.php b/Builder/Parts/Vehicle.php
new file mode 100644
index 0000000..7f627b7
--- /dev/null
+++ b/Builder/Parts/Vehicle.php
@@ -0,0 +1,22 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Builder\Parts;
+
+/**
+ * Vehicle is a contract for a vehicle
+ */
+abstract class Vehicle
+{
+
+    protected $data;
+
+    public function setPart($key, $value)
+    {
+        $this->data[$key] = $value;
+    }
+
+}
\ No newline at end of file
diff --git a/Builder/Parts/Wheel.php b/Builder/Parts/Wheel.php
new file mode 100644
index 0000000..d2b8950
--- /dev/null
+++ b/Builder/Parts/Wheel.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DesignPatterns\Builder\Parts;
+
+class Wheel
+{
+    
+}
\ No newline at end of file

From afcf985bdc71f050fd317bcf0c4f68cbd642a0e8 Mon Sep 17 00:00:00 2001
From: Trismegiste <florent.g@allopneus.com>
Date: Sun, 12 May 2013 12:31:03 +0200
Subject: [PATCH 2/2] a unit test for the builder pattern

---
 Tests/Builder/DirectorTest.php | 46 ++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 Tests/Builder/DirectorTest.php

diff --git a/Tests/Builder/DirectorTest.php b/Tests/Builder/DirectorTest.php
new file mode 100644
index 0000000..83e2234
--- /dev/null
+++ b/Tests/Builder/DirectorTest.php
@@ -0,0 +1,46 @@
+<?php
+
+/*
+ * DesignPatternPHP
+ */
+
+namespace DesignPatterns\Tests\Builder;
+
+use DesignPatterns\Builder\Director;
+use DesignPatterns\Builder\CarBuilder;
+use DesignPatterns\Builder\BikeBuilder;
+
+/**
+ * DirectorTest tests the builder pattern
+ */
+class DirectorTest extends \PHPUnit_Framework_TestCase
+{
+
+    protected $director;
+
+    protected function setUp()
+    {
+        $this->director = new Director();
+    }
+
+    public function getBuilder()
+    {
+        return array(
+            array(new CarBuilder()),
+            array(new BikeBuilder())
+        );
+    }
+
+    /**
+     * Here we test the build process. Notice that the client don't know
+     * anything about the contrete builder.
+     * 
+     * @dataProvider getBuilder
+     */
+    public function testBuild(\DesignPatterns\Builder\Builder $builder)
+    {
+        $newVehicle = $this->director->build($builder);
+        $this->assertInstanceOf('DesignPatterns\Builder\Parts\Vehicle', $newVehicle);
+    }
+
+}
\ No newline at end of file