第 12 章 命令模式

<?php
header("Content-type: text/html; charset=UTF-8");

/**
 * 命令模式
 *
 * 今天讲命令模式，这个模式从名字上看就很简单，命令嘛，老大发命令，小兵执行就是了，确实是这个意思，
 * 但是更深化了，用模式来描述真是是世界的命令情况。正在看这本书的你，我猜测分为两类：已经工作的和没有
 * 工作的，先说没有工作的，那你为啥要看这本书，为了以后工作呗，只要你参见工作，你肯定会待在项目组，那
 * 今天我们就以项目组为例子来讲述命令模式。
 *
 * 我是我们部门的项目经理，就是一个项目的头，在中国做项目，项目经理就是什么都要懂，什么都要管，做
 * 好了项目经理能分到一杯羹，做不好都是你项目经理的责任，这个是绝对的，我带过太多的项目，行政命令一压
 * 下来，那就一条道，做完做好！我们虽然是一个集团公司，但是我们部门是独立核算的，就是说呀，我们部门不
 * 仅仅为我们集团服务，还可以为其他甲方服务，赚取更多的外快，所以俺们的工资才能是中上等。在2007 年我
 * 带领了一个项目，比较小，但是钱可不少，是做什么的呢？为一家旅行社建立一套内部管理系统，管理他的客户、
 * 旅游资源、票务以及内部管理，整体上类似一个小型的ERP 系统，门店比较多，员工也比较多，但是需求比较
 * 明确，因为他们之前有一套自己购买的内部管理系统，这次变动部分模块基本上是翻版，而且旅行社有自己的
 * IT 部门，比较好相处，都是技术人员，没有交流鸿沟嘛。
 *
 * 这个项目的成员分工也是采用了常规的分工方式，分为需求组（Requirement Group，简称RG）、美工
 * 组（Page Group,简称PG）、代码组（我们内部还有一个比较优雅的名字：逻辑实现组，这里使用大家经常称
 * 呼的名称吧，英文缩写叫Code Group，简称CG）。
 */

/**
 * 项目组分成了三个组，每个组还是要接受增删改的命令
 */
abstract class Group {
    //甲乙双方分开办公，你要和那个组讨论，你首先要找到这个组
    public abstract function find();
    
    //被要求增加功能
    public abstract function add();
    
    //被要求删除功能
    public abstract function delete();
    
    //被要求修改功能
    public abstract function change();
    
    //被要求给出所有的变更计划
    public abstract function plan();
}

// 大家看抽象类中的每个方法，是不是每个都是一个命令？找到它，增加，删除，给我计划！是不是命令，这
// 也就是命令模式中的命令接收者角色(Receiver)，等会细讲。我们再看三个实现类，需求组最重要，没有需求
// 你还设计个P 呀，看RequirmentGroup 类的实现：

/**
 * 需求组的职责是和客户谈定需求，这个组的人应该都是业务领域专家
 */
class RequirementGroup extends Group {
    //客户要求需求组过去和他们谈
    public function find() {
        echo "找到需求组...<br>";
    }
    
    //客户要求增加一项需求
    public function add() {
        echo "客户要求增加一项需求...<br>";
    }
    
    //客户要求修改一项需求
    public function change() {
        echo "客户要求修改一项需求...<br>";
    }
    
    //客户要求删除一项需求
    public function delete() {
        echo "客户要求删除一项需求...<br>";
    }
    
    //客户要求出变更计划
    public function plan() {
        echo "客户要求需求变更计划...<br>";
    }
}

// 需求组有了，我们再看美工组，美工组也很重要，是项目的脸面，客户最终接触到的还是界面，这个非常重
// 要，看PageGroup 的实现：

/**
 * 美工组的职责是设计出一套漂亮、简单、便捷的界面
 */
class PageGroup extends Group {
    //首先这个美工组应该被找到吧，要不你跟谁谈？
    public function find() {
        echo "找到美工组...<br>";
    }
    
    //美工被要求增加一个页面
    public function add() {
        echo "客户要求增加一个页面...<br>";
    }
    
    //客户要求对现有界面做修改
    public function change() {
        echo "客户要求修改一个页面...<br>";
    }
    
    //甲方是老大，要求删除一些页面
    public function delete() {
        echo "客户要求删除一个页面...<br>";
    }
    
    //所有的增删改那要给出计划呀
    public function plan() {
        echo "客户要求页面变更计划...<br>";
    }
}

// 最后看代码组，这个组的成员一般都是比较闷骚型的，不多说话，但多做事儿，比较沉闷，这是这个组的典
// 型特点，我们来看看这个CodeGroup 类：

/**
 * 代码组的职责是实现业务逻辑，当然包括数据库设计了
 */
class CodeGroup extends Group {
    //客户要求代码组过去和他们谈
    public function find() {
        echo "找到代码组...<br>";
    }
    
    //客户要求增加一项功能
    public function add() {
        echo "客户要求增加一项功能...<br>";
    }
    
    //客户要求修改一项功能
    public function change() {
        echo "客户要求修改一项功能...<br>";
    }
    
    //客户要求删除一项功能
    public function delete() {
        echo "客户要求删除一项功能...<br>";
    }
    
    //客户要求出变更计划
    public function plan() {
        echo "客户要求代码变更计划...<br>";
    }
}

// Command 抽象类：客户发给我们的命令，定义三个工作组的成员变量，供子类使用；定义一个抽象方法
// execute，由子类来实现；

// Invoker 实现类:项目接头人，setComand 接受客户发给我我们的命令，action 方法是执行客户的命令
// （方法名写成是action 是与command 的execute 区分开，避免混淆）

// 我们先看Command 抽象类代码：

/**
 * 命令的抽象类，我们把客户发出的命令定义成一个一个的对象
 */
abstract class Command {
    /**
     * 需求组
     */
    protected $rg = null;
    
    /**
     * 美工组
     */
    protected $pg = null;
    
    /**
     * 代码组
     */
    protected $cg = null;
    
    /**
     * 初始化三个组对象，子类可以直接使用
     */
    public function __construct(){
        $this->rg = new RequirementGroup();
        $this->pg = new PageGroup();
        $this->cg = new CodeGroup();
    }
    
    /**
     * 只要一个方法，你要我做什么事情
     */
    public abstract function execute();
}

// 这个简单，看两个具体的实现类，先看AddRequeirementCommand 类, 这个类的作用就是增加一项需求。

/**
 * 增加一项需求
 *
 * 我们想想，客户要求增加一项需求，那是不是页面也增加，同时功能也要增加呢？
 * 如果不使用命令模式，客户就需要先找需求组，然后找美工组，然后找代码组，这个…，你想让客户跳楼呀！使
 * 用命令模式后，客户只管发命令模式，你增加一项需求，没问题，我内部调动三个组通力合作，然后反馈你结果，
 * 这也正是客户需要的，那这个要怎么修改呢？想想看，很简单的，在AddRequirementCommand 类的execute
 * 方法中增加对PageGroup 和CodePage 的调用就成了，代码如下：
 */
class AddRequirementCommand extends Command {
    /**
     * 执行增加一项需求的命令
     */
    public function execute() {
        //找到需求组
        $this->rg->find();
        
        //增加一份需求
        $this->rg->add();
        
        //页面也要增加
        $this->pg->add();
        
        //功能也要增加
        $this->cg->add();
        
        //给出计划
        $this->rg->plan();
    }
}

// 看删除一个页面的命令,DeletePageCommand 类：

/**
 * 删除一个页面的命令
 */
class DeletePageCommand extends Command {
    /**
     * 执行删除一个页面的命令
     */
    public function execute() {
        //找到页面组
        $this->pg->find();
        
        //删除一个页面
        $this->rg->delete();
        
        //给出计划
        $this->rg->plan();
    }
}

// Command 抽象类还可以有很多的子类，比如增加一个功能命令（AddCodeCommand），删除一份需求命令
// （DeleteRequirementCommand）等等，这里就不用描述了，都很简单。
// 我们再看我们的接头人，就是Invoker 类的实现：

/**
 * 接头人的职责就是接收命令，并执行
 */
class Invoker {
    /**
     * 什么命令
     */
    private $command;
    
    /**
     * 客户发出命令
     */
    public function setCommand(Command $command){
        $this->command = $command;
    }
    
    /**
     * 执行客户的命令
     */
    public function action(){
        $this->command->execute();
    }
}

//定义我们的接头人
$xiaoSan = new Invoker(); //接头人就是我小三

echo "-------------客户要求增加一项需求-----------------<br>";
$command = new AddRequirementCommand(); //客户给我们下命令来
$xiaoSan->setCommand($command); //接头人接收到命令
$xiaoSan->action(); //接头人执行命令

echo "<br>-------------客户要求删除一个页面-----------------<br>";
$command = new DeletePageCommand(); //客户给我们下命令来
$xiaoSan->setCommand($command); //接头人接收到命令
$xiaoSan->action(); //接头人执行命令

/**
 * 在这个模式中，我们看到三个角色：
 * Receiver 角色：这个就是干活的角色，命令传递到这里是应该被执行的，具体到上面我们的例子中就是Group 的三个实现类；
 * Command 角色：就是命令，需要我执行的所有命令都这里声明；
 * Invoker 角色：调用者，接收到命令，并执行命令，例子中我这里项目经理就是这个角色；
 * 命令模式比较简单，但是在项目中使用是非常频繁的，封装性非常好，因为它把请求方（Invoker）和执
 * 行方（Receiver）分开了，扩展性也有很好的保障。但是，命令模式也是有缺点的，你看Command 的子类没
 * 有，那个如果我要写下去的可不是几个，而是几十个，这个类膨胀的非常多，这个就需要大家在项目中自己考虑
 * 使用了。
 */

运行结果：

-------------客户要求增加一项需求-----------------
找到需求组...
客户要求增加一项需求...
客户要求增加一个页面...
客户要求增加一项功能...
客户要求需求变更计划...

-------------客户要求删除一个页面-----------------
找到美工组...
客户要求删除一项需求...
客户要求需求变更计划...