架构设计模式建造者模式

没有人买车会只买一个轮胎或者方向盘，大家买的都是一辆包含轮胎、方向盘和发动机等多个部件的完整汽车。如何将这些部件组装成一辆完整的汽车并返回给用户，这是建造者模式需要解决的问题。建造者模式又称为生成器模式，它是一种较为复杂、使用频率也相对较低的创建型模式。建造者模式为客户端返回的不是一个简单的产品，而是一个由多个部件组成的复杂产品。

建造者模式是较为复杂的创建型模式，它将客户端与包含多个组成部分（或部件）的复杂对象的创建过程分离，客户端无须知道复杂对象的内部组成部分与装配方式，只需要知道所需建造者的类型即可。它关注如何一步一步创建一个的复杂对象，不同的具体建造者定义了不同的创建过程，且具体建造者相互独立，增加新的建造者非常方便，无须修改已有代码，系统具有较好的扩展性。

建造者模式定义如下：

建造者模式 (Builder Pattern)：将一个复杂对象的构建与它的表示分离，使得同样的构建过程可以创建不同的表示。建造者模式是一种对象创建型模式。

建造者模式一步一步创建一个复杂的对象，它允许用户只通过指定复杂对象的类型和内容就可以构建它们，用户不需要知道内部的具体构建细节。建造者模式结构如图所示：

在建造者模式结构图中包含如下几个角色：

Builder（抽象建造者）：它为创建一个产品 Product 对象的各个部件指定抽象接口，在该接口中一般声明两类方法，一类方法是 buildPartX()，它们用于创建复杂对象的各个部件；另一类方法是 getResult()，它们用于返回复杂对象。Builder 既可以是抽象类，也可以是接口。
ConcreteBuilder（具体建造者）：它实现了 Builder 接口，实现各个部件的具体构造和装配方法，定义并明确它所创建的复杂对象，也提供一个方法返回创建好的复杂产品对象。
Product（产品角色）：它是被构建的复杂对象，包含多个组成部件，具体建造者创建该产品的内部表示并定义它的装配过程。
Director（指挥者）：指挥者又称为导演类，它负责安排复杂对象的建造次序，指挥者与抽象建造者之间存在关联关系，可以在其 construct() 建造方法中调用建造者对象的部件构造与装配方法，完成复杂对象的建造。客户端一般只需要与指挥者进行交互，在客户端确定具体建造者的类型，并实例化具体建造者对象（也可以通过配置文件和反射机制），然后通过指挥者类的构造函数或者 Setter 方法将该对象传入指挥者类中。

在建造者模式的定义中提到了复杂对象，那么什么是复杂对象？简单来说，复杂对象是指那些包含多个成员属性的对象，这些成员属性也称为部件或零件，如汽车包括方向盘、发动机、轮胎等部件，电子邮件包括发件人、收件人、主题、内容、附件等部件，一个典型的复杂对象类代码示例如下：

<?php

class Product
{
    // 定义部件，部件可以是任意类型，包括值类型和引用类型
    private $partA; 

    private $partB;

    private $partC;
}

在抽象建造者类中定义了产品的创建方法和返回方法，其典型代码如下：

<?php

abstract class Builder
{
    // 产品对象
    private $product;

    public abstract function buildPartA();

    public abstract function buildPartB();

    public abstract function buildPartC();
    
    // 创建产品对象
    public abstract function createProduct();

    // 返回产品对象
    public function getResult(): Product
    {return $this->product;}
}

在抽象类 Builder 中声明了一系列抽象的 buildPartX() 方法用于创建复杂产品的各个部件，具体建造过程在 ConcreteBuilder 中实现，此外还提供了工厂方法 getResult()，用于返回一个建造好的完整产品。

在 ConcreteBuilder 中实现了 buildPartX() 方法，不同的具体建造者在实现 buildPartX() 方法时将有所区别，而这些对于客户端来说都无须关心，客户端只需知道具体建造者类型即可。

在建造者模式的结构中还引入了一个指挥者类 Director，该类主要有两个作用：一方面它隔离了客户与创建过程；另一方面它控制产品的创建过程，包括某个 buildPartX() 方法是否被调用以及多个 buildPartX() 方法调用的先后次序等。指挥者针对抽象建造者编程，客户端只需要知道具体建造者的类型，即可通过指挥者类调用建造者的相关方法，返回一个完整的产品对象。在实际生活中也存在类似指挥者一样的角色，如一个客户去购买电脑，电脑销售人员相当于指挥者，只要客户确定电脑的类型，电脑销售人员可以通知电脑组装人员给客户组装一台电脑。指挥者类的代码示例如下：

<?php

class Director
{
    private $builder;

    public function __construct(Builder $builder)
    {$this->builder = $builder;}

    public function setBuilder(Builder $builder)
    {$this->builder = $builder;}

    // 产品构建与组装方法
    public function build(): Product
    {$this->builder->createProduct();
        $this->builder->buildPartA();
        $this->builder->buildPartB();
        $this->builder->buildPartC();

        return $this->builder->getResult();}
}

在指挥者类中可以注入一个抽象建造者类型的对象，其核心在于提供了一个建造方法 build()，在该方法中调用了 builder 对象的构造部件的方法，最后返回一个产品对象。

对于客户端而言，只需关心具体的建造者即可，一般情况下，客户端类代码片段如下所示：

// 可通过配置文件实现
$builder = new ConcreteBuilder();
$director = new Director($builder);
$product = $director->createProduct();

可以通过配置文件来存储具体建造者类 ConcreteBuilder 的类名，使得更换新的建造者时无须修改源代码，系统扩展更为方便。在客户端代码中，无须关心产品对象的具体组装过程，只需指定具体建造者的类型即可。

建造者模式与抽象工厂模式有点相似，但是建造者模式返回一个完整的复杂产品，而抽象工厂模式返回一系列相关的产品。在抽象工厂模式中，客户端通过选择具体工厂来生成所需对象，而在建造者模式中，客户端通过指定具体建造者类型并指导 Director 类如何去生成对象，侧重于一步步构造一个复杂对象，然后将结果返回。如果将抽象工厂模式看成一个汽车配件生产厂，生成不同类型的汽车配件，那么建造者模式就是一个汽车组装厂，通过对配件进行组装返回一辆完整的汽车。

Sunny 软件公司游戏开发小组决定开发一款名为《Sunny 群侠传》的网络游戏，该游戏采用主流的 RPG(Role Playing Game, 角色扮演游戏) 模式，玩家可以在游戏中扮演虚拟世界中的一个特定角色，角色根据不同的游戏情节和统计数据（如力量、魔法、技能等）具有不同的能力，角色也会随着不断升级而拥有更加强大的能力。
作为 RPG 游戏的一个重要组成部分，需要对游戏角色进行设计，而且随着该游戏的升级将不断增加新的角色。不同类型的游戏角色，其性别、脸型、服装、发型等外部特性都有所差异，例如“天使”拥有美丽的面容和披肩的长发，并身穿一袭白裙；而“恶魔”极其丑陋，留着光头并穿一件刺眼的黑衣。
Sunny 公司决定开发一个小工具来创建游戏角色，可以创建不同类型的角色并可以灵活增加新的角色。

无论是何种造型的游戏角色，它的创建步骤都大同小异，都需要逐步创建其组成部分，再将各组成部分装配成一个完整的游戏角色。Sunny 公司开发人员决定使用建造者模式来实现游戏角色的创建，其基本结构如图所示：

ActorController 充当指挥者，ActorBuilder 充当抽象建造者，HeroBuilder、AngelBuilder 和 DevilBuilder 充当具体建造者，Actor 充当复杂产品。完整代码如下所示：

<?php

//Actor 角色类：复杂产品
class Actor
{
    private $type; // 角色类型

    private $sex; // 性别

    private $face; // 脸型

    private $costume; // 服装

    private $hairstyle; // 发型

    public function setType(string $type)
    {$this->type = $type;}

    public function setSex(string $sex)
    {$this->sex = $sex;}

    public function setFace(string $face)
    {$this->face = $face;}

    public function setCostume(string $costume)
    {$this->costume = $costume;}

    public function setHairstyle(string $hairstyle)
    {$this->hairstyle = $hairstyle;}

    public function getType(): string
    {return $this->type;}

    public function getSex(): string
    {return $this->sex;}

    public function getFace(): string
    {return $this->face;}

    public function getCostume(): string
    {return $this->costume;}

    public function getHairstyle(): string
    {return $this->hairstyle;}
}

// 角色建造器：抽象建造者
abstract class ActorBuilder
{
    /**
     * @var Actor
     */
    protected $actor;

    public abstract function buildType();

    public abstract function buildSex();

    public abstract function buildFace();

    public abstract function buildCostume();

    public abstract function buildHairstyle();

    public function setActor()
    {$this->actor = new Actor();
    }

    // 工厂方法，返回一个完整的游戏角色对象
    public function createActor(): Actor
    {return $this->actor;}
}

// 英雄角色建造器：具体建造者
class HeroBuilder extends ActorBuilder
{public function buildType()
    {$this->actor->setType('英雄');
    }

    public function buildSex()
    {$this->actor->setSex('男');
    }

    public function buildFace()
    {$this->actor->setFace('英俊');
    }

    public function buildCostume()
    {$this->actor->getCostume('盔甲');
    }

    public function buildHairstyle()
    {$this->actor->setHairstyle('飘逸');
    }
}

// 天使角色建造器：具体建造者
class AngelBuilder extends ActorBuilder
{public function buildType()
    {$this->actor->setType('天使');
    }

    public function buildSex()
    {$this->actor->setSex('女');
    }

    public function buildFace()
    {$this->actor->setFace('漂亮');
    }

    public function buildCostume()
    {$this->actor->setCostume('白裙');
    }

    public function buildHairstyle()
    {$this->actor->setHairstyle('披肩长发');
    }
}

// 恶魔角色建造器：具体建造者
class DevilBuilder extends ActorBuilder
{public function buildType()
    {$this->actor->setType('恶魔');
    }

    public function buildSex()
    {$this->actor->setSex('男');
    }

    public function buildFace()
    {$this->actor->setFace('丑陋');
    }

    public function buildCostume()
    {$this->actor->setCostume('黑衣');
    }

    public function buildHairstyle()
    {$this->actor->setHairstyle('光头');
    }
}

// 游戏角色创建控制器：指挥者
class ActorController
{
    // 逐步构建复杂产品对象
    public function construct(ActorBuilder $builder): Actor
    {$builder->setActor();
        $builder->buildType();
        $builder->buildSex();
        $builder->buildFace();
        $builder->buildCostume();
        $builder->buildHairstyle();

        return $builder->createActor();}
}

为了提高系统的灵活性和可扩展性，我们将具体建造者类的类名存储在配置文件中，并通过工具类 ConfigUtil 来读取配置文件并反射生成对象。

在建造者模式中，客户端只需实例化指挥者类，指挥者类针对抽象建造者编程，客户端根据需要传入具体的建造者类型，指挥者将指导具体建造者一步一步构造一个完整的产品（逐步调用具体建造者的 buildX() 方法），相同的构造过程可以创建完全不同的产品。在游戏角色实例中，如果需要更换角色，只需要修改配置文件，更换具体角色建造者类即可；如果需要增加新角色，可以增加一个新的具体角色建造者类作为抽象角色建造者的子类，再修改配置文件即可，原有代码无须修改，完全符合“开闭原则”。

在有些情况下，为了简化系统结构，可以将 Director 和抽象建造者 Builder 进行合并，在 Builder 中提供逐步构建复杂产品对象的 construct() 方法。如果将游戏角色设计中的指挥者类 ActorController 省略，ActorBuilder 类的代码修改如下：

abstract class ActorBuilder
{
    /**
     * @var Actor
     */
    protected $actor;

    public abstract function buildType();

    public abstract function buildSex();

    public abstract function buildFace();

    public abstract function buildCostume();

    public abstract function buildHairstyle();

    public function setActor()
    {$this->actor = new Actor();
    }

    public function construct(): Actor
    {$this->setActor();
        $this->buildType();
        $this->buildSex();
        $this->buildFace();
        $this->buildCostume();
        $this->buildHairstyle();

        return $this->actor;
    }
}

此时，construct() 方法定义了其他 buildPartX() 方法调用的次序，为其他方法的执行提供了一个流程模板，这与模板方法模式非常类似。

以上方式不影响系统的灵活性和可扩展性，同时还简化了系统结构，但加重了抽象建造者类的职责，如果 construct() 方法较为复杂，待构建产品的组成部分较多，建议还是将 construct() 方法单独封装在 Director 中，这样做更符合“单一职责原则”。

建造者模式的核心在于如何一步步构建一个包含多个组成部件的完整对象，使用相同的构建过程构建不同的产品，在软件开发中，如果我们需要创建复杂对象并希望系统具备很好的灵活性和可扩展性可以考虑使用建造者模式。

主要优点

在建造者模式中，客户端不必知道产品内部组成的细节，将产品本身与产品的创建过程解耦，使得相同的创建过程可以创建不同的产品对象。
每一个具体建造者都相对独立，而与其他的具体建造者无关，因此可以很方便地替换具体建造者或增加新的具体建造者，用户使用不同的具体建造者即可得到不同的产品对象。由于指挥者类针对抽象建造者编程，增加新的具体建造者无须修改原有类库的代码，系统扩展方便，符合“开闭原则”。
可以更加精细地控制产品的创建过程。将复杂产品的创建步骤分解在不同的方法中，使得创建过程更加清晰，也更方便使用程序来控制创建过程。

主要缺点

建造者模式所创建的产品一般具有较多的共同点，其组成部分相似，如果产品之间的差异性很大，例如很多组成部分都不相同，不适合使用建造者模式，因此其使用范围受到一定的限制。
如果产品的内部变化复杂，可能会导致需要定义很多具体建造者类来实现这种变化，导致系统变得很庞大，增加系统的理解难度和运行成本。

适用场景

需要生成的产品对象有复杂的内部结构，这些产品对象通常包含多个成员属性。
需要生成的产品对象的属性相互依赖，需要指定其生成顺序。
对象的创建过程独立于创建该对象的类。在建造者模式中通过引入了指挥者类，将创建过程封装在指挥者类中，而不在建造者类和客户类中。
隔离复杂对象的创建和使用，并使得相同的创建过程可以创建不同的产品。

架构设计模式建造者模式

概述

案例

讨论

总结

主要优点

主要缺点

适用场景

Just My Socks（注册教程内含优惠码）

架构设计模式建造者模式

概述

案例

讨论

总结

主要优点

主要缺点

适用场景

Just My Socks（注册教程 内含优惠码）

Just My Socks（注册教程内含优惠码）