架构设计模式命令模式

装修新房的最后几道工序之一是安装插座和开关，通过开关可以控制一些电器的打开和关闭，例如电灯或者排气扇。在购买开关时，我们并不知道它将来到底用于控制什么电器，也就是说，开关与电灯、排气扇并无直接关系，一个开关在安装之后可能用来控制电灯，也可能用来控制排气扇或者其他电器设备。开关与电器之间通过电线建立连接，如果开关打开，则电线通电，电器工作；反之，开关关闭，电线断电，电器停止工作。相同的开关可以通过不同的电线来控制不同的电器。

在软件开发中也存在很多与开关和电器类似的请求发送者和接收者对象，例如一个按钮，它可能是一个“关闭窗口”请求的发送者，而按钮点击事件处理类则是该请求的接收者。为了降低系统的耦合度，将请求的发送者和接收者解耦，我们可以使用一种被称之为命令模式的设计模式来设计系统，在命令模式中，发送者与接收者之间引入了新的命令对象，将发送者的请求封装在命令对象中，再通过命令对象来调用接收者的方法。

在软件开发中，我们经常需要向某些对象发送请求（调用其中的某个或某些方法），但是并不知道请求的接收者是谁，也不知道被请求的操作是哪个，此时，我们特别希望能够以一种松耦合的方式来设计软件，使得请求发送者与请求接收者能够消除彼此之间的耦合，让对象之间的调用关系更加灵活，可以灵活地指定请求接收者以及被请求的操作。命令模式为此类问题提供了一个较为完美的解决方案。

命令模式可以将请求发送者和接收者完全解耦，发送者与接收者之间没有直接引用关系，发送请求的对象只需要知道如何发送请求，而不必知道如何完成请求。

命令模式定义如下：

命令模式 (Command Pattern)：将一个请求封装为一个对象，从而让我们可用不同的请求对客户进行参数化；对请求排队或者记录请求日志，以及支持可撤销的操作。命令模式是一种对象行为型模式，其别名为动作(Action) 模式或事务 (Transaction) 模式。

命令模式的定义比较复杂，提到了很多术语，例如“用不同的请求对客户进行参数化”、“对请求排队”，“记录请求日志”、“支持可撤销操作”等，在后面将对这些术语进行一一讲解。

命令模式的核心在于引入了命令类，通过命令类来降低发送者和接收者的耦合度，请求发送者只需指定一个命令对象，再通过命令对象来调用请求接收者的处理方法，其结构如图所示：

在命令模式结构图中包含如下几个角色：

Command（抽象命令类）：抽象命令类一般是一个抽象类或接口，在其中声明了用于执行请求的 execute()等方法，通过这些方法可以调用请求接收者的相关操作。
ConcreteCommand（具体命令类）：具体命令类是抽象命令类的子类，实现了在抽象命令类中声明的方法，它对应具体的接收者对象，将接收者对象的动作绑定其中。在实现 execute()方法时，将调用接收者对象的相关操作(Action)。
Invoker（调用者）：调用者即请求发送者，它通过命令对象来执行请求。一个调用者并不需要在设计时确定其接收者，因此它只与抽象命令类之间存在关联关系。在程序运行时可以将一个具体命令对象注入其中，再调用具体命令对象的 execute()方法，从而实现间接调用请求接收者的相关操作。
Receiver（接收者）：接收者执行与请求相关的操作，它具体实现对请求的业务处理。

命令模式的本质是对请求进行封装，一个请求对应于一个命令，将发出命令的责任和执行命令的责任分割开。每一个命令都是一个操作：请求的一方发出请求要求执行一个操作；接收的一方收到请求，并执行相应的操作。命令模式允许请求的一方和接收的一方独立开来，使得请求的一方不必知道接收请求的一方的接口，更不必知道请求如何被接收、操作是否被执行、何时被执行，以及是怎么被执行的。

命令模式的关键在于引入了抽象命令类，请求发送者针对抽象命令类编程，只有实现了抽象命令类的具体命令才与请求接收者相关联。在最简单的抽象命令类中只包含了一个抽象的 execute()方法，每个具体命令类将一个 Receiver 类型的对象作为一个实例变量进行存储，从而具体指定一个请求的接收者，不同的具体命令类提供了 execute()方法的不同实现，并调用不同接收者的请求处理方法。

典型的抽象命令类代码如下所示：

abstract class Command
{abstract public function execute();
}

对于请求发送者即调用者而言，将针对抽象命令类进行编程，可以通过构造注入或者设值注入的方式在运行时传入具体命令类对象 ， 并在业务方法中调用命令对象的 execute()方法，其典型代码如下所示：

class Invoker
{
    private $command;

    // 构造注入
    public function __construct(Command $command)
    {$this->command = $command;}

    // 设值注入
    public function setCommand(Command $command)
    {$this->command = $command;}

    // 业务方法，用于调用命令类的 execute()方法
    public function call()
    {$this->command->execute();
    }
}

具体命令类继承了抽象命令类，它与请求接收者相关联，实现了在抽象命令类中声明的 execute()方法，并在实现时调用接收者的请求响应方法 action()，其典型代码如下所示：

class ConcreteCommand extends Command
{
    // 维持一个对请求接收者对象的引用
    private $receiver;

    public function execute()
    {// 调用请求接收者的业务处理方法 action()
        $this->receiver->action();}
}

请求接收者 Receiver 类具体实现对请求的业务处理，它提供了 action()方法，用于执行与请求相关的操作，其典型代码如下所示：

class Receiver
{public function action()
    {// 具体操作}
}

Sunny 软件公司开发人员为公司内部 OA 系统开发了一个桌面版应用程序，该应用程序为用户提供了一系列自定义功能键，用户可以通过这些功能键来实现一些快捷操作。Sunny 软件公司开发人员通过分析，发现不同的用户可能会有不同的使用习惯，在设置功能键的时候每个人都有自己的喜好，例如有的人喜欢将第一个功能键设置为“打开帮助文档”，有的人则喜欢将该功能键设置为“最小化至托盘”，为了让用户能够灵活地进行功能键的设置，开发人员提供了一个“功能键设置”窗口，该窗口界面如图所示：

通过如图所示界面，用户可以将功能键和相应功能绑定在一起，还可以根据需要来修改功能键的设置，而且系统在未来可能还会增加一些新的功能或功能键。

为了降低功能键与功能处理类之间的耦合度，让用户可以自定义每一个功能键的功能，Sunny 软件公司开发人员使用命令模式来设计“自定义功能键”模块，其核心结构如图所示：

FBSettingWindow 是“功能键设置”界面类，FunctionButton 充当请求调用者，Command 充当抽象命令类，MinimizeCommand 和 HelpCommand 充当具体命令类，WindowHanlder 和 HelpHandler 充当请求接收者。完整代码如下所示：

<?php

// 功能键设置窗口类
class FBSettingWindow
{
    private $title; // 窗口标题

    // 定义一个数组来存储所有功能键
    private $functionButtons = [];

    public function __construct(string $title)
    {$this->title = $title;}

    public function setTitle(string $title)
    {$this->title = $title;}

    public function getTitle(): string
    {return $this->title;}

    public function addFunctionButton(FunctionButton $fb)
    {$this->functionButtons[] = $fb;
    }

    public function removeFunctionButton(FunctionButton $fb)
    {unset($this->functionButtons[array_search($fb, $this->functionButtons)]);
    }

    // 显示窗口及功能键
    public function display()
    {foreach ($this->functionButtons as $button) {$button->getName();
        }
    }
}

// 功能键类：请求发送者
class FunctionButton
{
    private $name; // 功能键名称
    private $command; // 维持一个抽象命令对象的引用

    public function __construct(string $name)
    {$this->name = $name;}

    public function getName(): string
    {return $this->name;}

    // 为功能键注入命令
    public function setCommand(Command $command)
    {$this->command = $command;}

    // 发送请求的方法
    public function onClick()
    {$this->command->execute();
    }
}

// 抽象命令类
abstract class Command
{abstract public function execute();
}

// 帮助命令类：具体命令类
class HelpCommand extends Command
{
    private $hhObj; // 维持对请求接收者的引用

    public function __construct()
    {$this->hhObj = new HelpHandler();
    }

    // 命令执行方法，将调用请求接收者的业务方法
    public function execute()
    {$this->hhObj->display();
    }
}

// 最小化命令类：具体命令类
class MinimizeCommand extends Command
{
    private $whObj; // 维持对请求接收者的引用

    public function __construct()
    {$this->whObj = new WindowHanlder();
    }

    // 命令执行方法，将调用请求接收者的业务方法
    public function execute()
    {$this->whObj->minimize();
    }
}

// 窗口处理类：请求接收者
class WindowHanlder
{public function minimize()
    {echo '窗口最小化';}
}

// 帮助文档处理类：请求接收者
class HelpHandler
{public function display()
    {echo '显示帮助文档';}
}

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

如果需要修改功能键的功能，例如某个功能键可以实现“自动截屏”，只需要对应增加一个新的具体命令类，在该命令类与屏幕处理者 (ScreenHandler) 之间创建一个关联关系，然后将该具体命令类的对象通过配置文件注入到某个功能键即可，原有代码无须修改，符合“开闭原则”。在此过程中，每一个具体命令类对应一个请求的处理者（接收者），通过向请求发送者注入不同的具体命令对象可以使得相同的发送者对应不同的接收者，从而实现“将一个请求封装为一个对象，用不同的请求对客户进行参数化”，客户端只需要将具体命令对象作为参数注入请求发送者，无须直接操作请求的接收者。

有时候我们需要 将多个请求排队，当一个请求发送者发送一个请求时，将不止一个请求接收者产生响应，这些请求接收者将逐个执行业务方法，完成对请求的处理 。此时，我们可以通过 命令队列 来实现。

命令队列的实现方法有多种形式，其中最常用、灵活性最好的一种方式是增加一个 CommandQueue 类，由该类来负责存储多个命令对象，而不同的命令对象可以对应不同的请求接收者，CommandQueue 类的典型代码如下所示：

class CommandQueue
{
    // 定义一个数组来存储命令队列
    private $commands = [];

    public function addCommand(Command $command)
    {$this->commands[] = $command;
    }

    public function removeCommand(Command $command)
    {unset($this->commands[array_search($command, $this->commands)]);
    }

    // 循环调用每一个命令对象的 execute()方法
    public function execute()
    {foreach ($this->commands as $command) {$command->execute();
        }
    }
}

在增加了命令队列类 CommandQueue 以后，请求发送者类 Invoker 将针对 CommandQueue 编程，代码修改如下：

class Invoker
{
    private $commandQueue; // 维持一个 CommandQueue 对象的引用

    // 构造注入
    public function __construct(CommandQueue $commandQueue)
    {$this->commandQueue = $commandQueue;}

    // 设值注入
    public function setCommandQueue(CommandQueue $commandQueue)
    {$this->commandQueue = $commandQueue;}

    // 调用 CommandQueue 类的 execute()方法
    public function call()
    {$this->commandQueue->execute();
    }
}

命令队列与我们常说的“批处理”有点类似。批处理，顾名思义，可以对一组对象（命令）进行批量处理，当一个发送者发送请求后，将有一系列接收者对请求作出响应，命令队列可以用于设计批处理应用程序，如果请求接收者的接收次序没有严格的先后次序，我们还可以使用多线程技术来并发调用命令对象的 execute()方法，从而提高程序的执行效率。

在命令模式中，我们可以通过调用一个命令对象的 execute()方法来实现对请求的处理，如果需要撤销 (Undo) 请求，可通过在命令类中增加一个逆向操作来实现。

下面通过一个简单的实例来学习如何使用命令模式实现撤销操作：

Sunny 软件公司欲开发一个简易计算器，该计算器可以实现简单的数学运算，还可以对运算实施撤销操作。

Sunny 软件公司开发人员使用命令模式设计了如图所示结构图，其中计算器界面类 CalculatorForm 充当请求发送者，实现了数据求和功能的加法类 Adder 充当请求接收者，界面类可间接调用加法类中的 add()方法实现加法运算，并且提供了可撤销加法运算的 undo()方法。

本实例完整代码如下所示：

<?php

// 加法类：请求接收者
class Adder
{
    private $num = 0; // 定义初始值为 0

    // 加法操作，每次将传入的值与 num 作加法运算，再将结果返回
    public function add(int $value): int
    {return $this->num += $value;}
}

// 抽象命令类
abstract class AbstractCommand
{abstract public function execute(int $value): int; // 声明命令执行方法 execute()

    abstract public function undo(): int; // 声明撤销方法 undo()
}

// 具体命令类
class ConcreteCommand extends AbstractCommand
{
    private $adder;
    private $value;

    public function __construct()
    {$this->adder = new Adder();
    }

    // 实现抽象命令类中声明的 execute()方法，调用加法类的加法操作
    public function execute(int $value): int
    {
        $this->value = $value;

        return $this->adder->add($value);
    }

    // 实现抽象命令类中声明的 undo()方法，通过加一个相反数来实现加法的逆向操作
    public function undo(): int
    {return $this->adder->add(-$this->value);
    }
}

// 计算器界面类：请求发送者
class CalculatorForm
{
    private $command;

    public function setCommand(AbstractCommand $command)
    {$this->command = $command;}

    // 调用命令对象的 execute()方法执行运算
    public function compute(int $value)
    {return $this->command->execute($value);
    }

    // 调用命令对象的 undo()方法执行撤销
    public function undo()
    {return $this->command->undo();
    }
}

需要注意的是在本实例中只能实现一步撤销操作，因为没有保存命令对象的历史状态，可以通过引入一个命令集合或其他方式来存储每一次操作时命令的状态，从而实现多次撤销操作。除了 Undo 操作外，还可以采用类似的方式实现恢复 (Redo) 操作，即恢复所撤销的操作（或称为 二次撤销）。

请求日志就是将请求的历史记录保存下来，通常以 日志文件 (Log File) 的形式永久存储在计算机中。很多系统都提供了日志文件，例如 Windows 日志文件、Oracle 日志文件等，日志文件可以记录用户对系统的一些操作（例如对数据的更改）。请求日志文件可以实现很多功能，常用功能如下：

“天有不测风云”，一旦系统发生故障，日志文件可以为系统提供一种恢复机制，在请求日志文件中可以记录用户对系统的每一步操作，从而让系统能够顺利恢复到某一个特定的状态；
请求日志也可以用于实现批处理，在一个请求日志文件中可以存储一系列命令对象，例如一个命令队列；
可以将命令队列中的所有命令对象都存储在一个日志文件中，每执行一个命令则从日志文件中删除一个对应的命令对象，防止因为断电或者系统重启等原因造成请求丢失，而且可以避免重新发送全部请求时造成某些命令的重复执行，只需读取请求日志文件，再继续执行文件中剩余的命令即可。

在实现请求日志时，我们可以将命令对象通过序列化写到日志文件中。

宏命令 (Macro Command) 又称为组合命令，它是组合模式和命令模式联用的产物。宏命令是一个具体命令类，它拥有一个集合属性，在该集合中包含了对其他命令对象的引用。通常宏命令不直接与请求接收者交互，而是通过它的成员来调用接收者的方法。当调用宏命令的 execute()方法时，将递归调用它所包含的每个成员命令的 execute()方法，一个宏命令的成员可以是简单命令，还可以继续是宏命令。执行一个宏命令将触发多个具体命令的执行，从而实现对命令的批处理，其结构如图所示：

命令模式是一种使用频率非常高的设计模式，它可以将请求发送者与接收者解耦，请求发送者通过命令对象来间接引用请求接收者，使得系统具有更好的灵活性和可扩展性。在基于 GUI 的软件开发，无论是在电脑桌面应用还是在移动应用中，命令模式都得到了广泛的应用。

主要优点

降低系统的耦合度。由于请求者与接收者之间不存在直接引用，因此请求者与接收者之间实现完全解耦，相同的请求者可以对应不同的接收者，同样，相同的接收者也可以供不同的请求者使用，两者之间具有良好的独立性。
新的命令可以很容易地加入到系统中。由于增加新的具体命令类不会影响到其他类，因此增加新的具体命令类很容易，无须修改原有系统源代码，甚至客户类代码，满足“开闭原则”的要求。
可以比较容易地设计一个命令队列或宏命令（组合命令）。
为请求的撤销 (Undo) 和恢复 (Redo) 操作提供了一种设计和实现方案。

主要缺点

使用命令模式可能会导致某些系统有过多的具体命令类。因为针对每一个对请求接收者的调用操作都需要设计一个具体命令类，因此在某些系统中可能需要提供大量的具体命令类，这将影响命令模式的使用。

适用场景

系统需要将请求调用者和请求接收者解耦，使得调用者和接收者不直接交互。请求调用者无须知道接收者的存在，也无须知道接收者是谁，接收者也无须关心何时被调用。
系统需要在不同的时间指定请求、将请求排队和执行请求。一个命令对象和请求的初始调用者可以有不同的生命期，换言之，最初的请求发出者可能已经不在了，而命令对象本身仍然是活动的，可以通过该命令对象去调用请求接收者，而无须关心请求调用者的存在性，可以通过请求日志文件等机制来具体实现。
系统需要支持命令的撤销 (Undo) 操作和恢复 (Redo) 操作。
系统需要将一组操作组合在一起形成宏命令。

架构设计模式命令模式

概述

案例

命令队列的实现

撤销操作的实现

请求日志

宏命令

总结

主要优点

主要缺点

适用场景

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

架构设计模式命令模式

概述

案例

命令队列的实现

撤销操作的实现

请求日志

宏命令

总结

主要优点

主要缺点

适用场景

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

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