Neil 啃设计模式（0x04）建造者模式

建造者模式（Builder Pattern）

定义

Separate the construction of a complex object from its representation so that the same construction process can create different representations.（将一个复杂对象的构建与它的表示分离，使得一样的构建过程能够建立不一样的表示。）
《设计模式之禅》

UML 示例

以建立不一样口味 pizza 的过程为例，Margarita Pizza 和 CreamyBacon Pizza，而 Waiter 做为一个 Director， Pizza 是最终实现出来的产品。

@startuml
Interface Builder
class MargaritaBuilder
class CreamyBaconBuilder
class Pizza
note left: 每一个builder会建立本身的Pizza样式，而Pizza定义的内容不多
class Waiter
note left: waiter负责按照必定的执行顺序依次执行具体的builder中的步骤，产生一个pizza
Waiter #-- Builder
Builder <|-- MargaritaBuilder
Builder <|-- CreamyBaconBuilder
MargaritaBuilder ..> Pizza
CreamyBaconBuilder ..> Pizza

@enduml

代码实现

代码样例来自《精通 python 设计模式》

# coding: utf-8

from enum import Enum
import time

# 定义执行过程和Pizza口味的打印信息
PizzaProgress = Enum('PizzaProgress', 'queued preparation baking ready')
PizzaDough = Enum('PizzaDough', 'thin thick')
PizzaSauce = Enum('PizzaSauce', 'tomato creme_fraiche')
PizzaTopping = Enum('PizzaTopping', 'mozzarella double_mozzarella bacon ham mushrooms red_onion oregano')
STEP_DELAY = 3          # 考虑是示例，单位为秒


class Pizza:
    # 要建立的产品，pizza，包含几个部分dough、sauce、topping
    def __init__(self, name):
        self.name = name
        self.dough = None
        self.sauce = None
        self.topping = []

    def __str__(self):
        return self.name

    # 此段代码也能够在builder中实现，目的是为了展现不单单是能够定义Pizza属性，也能够定义一些方法，
    # 来让builder调用
    def prepare_dough(self, dough):
        self.dough = dough
        print('preparing the {} dough of your {}...'.format(self.dough.name, self))
        time.sleep(STEP_DELAY)
        print('done with the {} dough'.format(self.dough.name))


class MargaritaBuilder:

    def __init__(self):
        # builder类建立的margatita pizza对象
        # 此处可以表现出产品的建立由builder类建立
        self.pizza = Pizza('margarita')
        self.progress = PizzaProgress.queued
        self.baking_time = 5        # 考虑是示例，单位为秒

    # 以下的过程都是builder类抽象出的统一接口，全部的builder都有这些接口，因为python与java不一样，能够不用提早定义抽象类来继承
    def prepare_dough(self):
        self.progress = PizzaProgress.preparation
        self.pizza.prepare_dough(PizzaDough.thin)

    def add_sauce(self):
        print('adding the tomato sauce to your margarita...')
        self.pizza.sauce = PizzaSauce.tomato
        time.sleep(STEP_DELAY)
        print('done with the tomato sauce')

    def add_topping(self):
        print('adding the topping (double mozzarella, oregano) to your margarita')
        # 此处实在topping的0位置添加了一个[]list
        self.pizza.topping.append([i for i in
                                   (PizzaTopping.double_mozzarella, PizzaTopping.oregano)])
        time.sleep(STEP_DELAY)
        print('done with the topping (double mozzarrella, oregano)')

    def bake(self):
        self.progress = PizzaProgress.baking
        print('baking your margarita for {} seconds'.format(self.baking_time))
        time.sleep(self.baking_time)
        self.progress = PizzaProgress.ready
        print('your margarita is ready')


class CreamyBaconBuilder:

    def __init__(self):
        self.pizza = Pizza('creamy bacon')
        self.progress = PizzaProgress.queued
        self.baking_time = 7        # 考虑是示例，单位为秒

    def prepare_dough(self):
        self.progress = PizzaProgress.preparation
        self.pizza.prepare_dough(PizzaDough.thick)

    def add_sauce(self):
        print('adding the crème fraîche sauce to your creamy bacon')
        self.pizza.sauce = PizzaSauce.creme_fraiche
        time.sleep(STEP_DELAY)
        print('done with the crème fraîche sauce')

    def add_topping(self):
        print('adding the topping (mozzarella, bacon, ham, mushrooms, red onion, oregano) to your creamy bacon')
        self.pizza.topping.append([t for t in
                                   (PizzaTopping.mozzarella, PizzaTopping.bacon,
                                    PizzaTopping.ham, PizzaTopping.mushrooms,
                                    PizzaTopping.red_onion, PizzaTopping.oregano)])
        time.sleep(STEP_DELAY)
        print('done with the topping (mozzarella, bacon, ham, mushrooms, red onion, oregano)')

    def bake(self):
        self.progress = PizzaProgress.baking
        print('baking your creamy bacon for {} seconds'.format(self.baking_time))
        time.sleep(self.baking_time)
        self.progress = PizzaProgress.ready
        print('your creamy bacon is ready')


# waiter做为一个director定义了执行过程
class Waiter:

    def __init__(self):
        self.builder = None

    def construct_pizza(self, builder):
        self.builder = builder
        # step by step一步一步的执行pizza的制做过程
        [step() for step in (builder.prepare_dough,
                             builder.add_sauce, builder.add_topping, builder.bake)]

    @property
    def pizza(self):
        return self.builder.pizza


def validate_style(builders):
    try:
        pizza_style = input('What pizza would you like, [m]argarita or [c]reamy bacon? ')
        builder = builders[pizza_style]() # 根据用户输入产生builder
        valid_input = True
    except KeyError as err:
        print('Sorry, only margarita (key m) and creamy bacon (key c) are available')
        return (False, None)
    return (True, builder)


def main():
    builders = dict(m=MargaritaBuilder, c=CreamyBaconBuilder)
    valid_input = False
    while not valid_input:
        valid_input, builder = validate_style(builders)
    print()
    waiter = Waiter()
    waiter.construct_pizza(builder)
    pizza = waiter.pizza
    print()
    print('Enjoy your {}!'.format(pizza))

if __name__ == '__main__':
    main()

应用场景

• 建造者模式我的理解是客户化，定制化装配过程的时候须要使用到的。
• 建造者模式与工厂模式的区别就在于工厂模式的产品是固定规格的，写死的，非定制化的。就比如是本身买的品牌型号固定的电脑，仍是本身组装一台电脑同样。前者是全部参数固定了，然后者参数由客户本身决定。
• 怎样理解将构建与表示分离? 构建就是建立的过程，一个产品应该是一个复杂的产品，由多个组成部分构成，而产品的构建过程有一个统一的流程能够被抽象或者定义，而具体的实现是由每一个 builder 类实例定制化的。
• 表示就是指一个产品的各个属性，而构建就是如何赋值这些属性，这些属性该赋予什么指等等是由 builder 来构建的。
• 因此这样的好处就是建立一个 product，product 类只是提供简单的属性定义，而具体赋予什么值，是由每一个具体的 builder 定制的。好比上面例子中的 Pizza，Pizza 的属性或者不成部分就只这些，而不一样的 builder 就会不予不一样的值。最终是由 builder 建立出的 Pizza
• 而 director 是根据客户须要，调用不一样 builder 的一个执行者，是将调用的动做进行封装，因为 builder 会提供多个执行步骤，而对于这些执行步骤的执行是不但愿被用户看到的，因此进行了封装。有了 director 类

知识点

• 学习 enum 的使用
• 编程中调用一系列函数的简化流程，代表 step by step 的流程，打包一个流程的方式

[step() for step in (builder.prepare_dough,
                             builder.add_sauce, builder.add_topping, builder.bake)]

下集预告 模板模式