重做(redo)和撤销(undo)的完整实现

   undo-redo需要备忘录模式和命令模式做支撑，之前有学习过了command模式和memento模式的一些基本知识。这里要结合两个模式实现一个undo-redo操作的模块，巩固所学的知识。

系统框图：

    

     命令分发控制器主要有四个任务：
    1.系统初始化,加载系统配置参数并把这些数据缓存起来，这些应用程序级别的配置参数可以使用序列化机制，把数据缓存而不用每次去读取文件，加快访问效率。
    2.根据前端请求，收集参数生成一个请求(Request)。
    3.把请求映射到具体业务逻辑的命令模块(Command)。
    4.执行操作并把结果返回给前端视图。

    业务逻辑层根据传入的context对象可以获取执行参数，执行完毕后还可以把执行结果通过context对象返回给上一层。

    命令分发控制器的实现：

class Controller{private function __construct() {}static function run(){$instance = new Controller();$instance->init();$instance->handleRequest();}function init(){$application= \base\ApplicationHelper::instance();$application->system_init();}function handleRequest(){$request  = new \controller\Request();$cmd_r = new \command\CommandResolver();$cmd = $cmd_r->get_command($request);$cmd->execute($request);}}

     通过把构造函数声明为private，controller为一个单例。

     对于类似PHP这样的解释型的语言，要实现undeo/redo机制，必须用到一些缓存机制(session)来保存命令执行的历史记录。这里的session模块主要负责维护一个命令历史记录，其实现如下：

namespace base;require_once('session_registry.php');class SessionMementoTaker extends SessionRegistry{const COMMAND_COUNT = 5;private $persent = 0;private $cmd_stack = array();static public function instance(){return parent::instance();}public function push_command(Command $cmd){$this->cmd_stack = self::instance()->get('cmd_stack');if(!empty($this->cmd_stack)){if(count($this->cmd_stack) >self::COMMAND_COUNT){array_shift($this->cmd_stack);reset($this->cmd_stack);}} array_push($this->cmd_stack, $cmd);$this->persent = count($this->cmd_stack) + 1;self::instance()->set('cmd_stack', $this->cmd_stack);self::instance()->set('cmd_persent', $this->persent);}public function get_undo_command(){$this->persent = self::instance()->get('cmd_persent');$this->cmd_stack = self::instance()->get('cmd_stack');if(!empty($this->cmd_stack) && $this->persent > 0){$command = $this->cmd_stack[--$this->persent];self::instance()->set('cmd_persent', $this->persent);return $command;}return null;}public function get_redo_command(){$this->persent = self::instance()->get('cmd_persent');$this->cmd_stack = self::instance()->get('cmd_stack');if(!empty($this->cmd_stack) && $this->persent < count($this->cmd_stack)){$command = $this->cmd_stack[$this->persent++];self::instance()->set('cmd_persent', $this->persent);return $command;}return null;}}

    SessionMementoTaker的实现基于之前实现的一个会话（注册表模式）。根据cookies里面存储的会话ID恢复不同的对象数据，可以达到同一用户多次请求访问同一对象数据的目的。SessionMementoTaker额外提供了三个接口，push_command操作添加命令到历史命令列表。历史命令列表最大长度为5个，超过5个把最开始的命令移除。另外，push_command相当于添加一个新的命令，要把命令指针(persent)移动到最新的位置。舍弃之前的状态。get_undo_command获取最后一次执行的历史命令并更新指针，get_redo_command同理。
    历史命令列表： command1---command2---command3---* 星号表示persent，指向最新要执行的命令。
    一次undo操作：command1---command2-*--command3--- 回滚之后persent指针往后移动。
    一次undo操作：command1--*command2----command3--- 回滚之后persent指针往后移动。
    一次redo操作：command1---command2-*--command3--- 重做之后persent指针往前移动。
    push_command：command1---command2---command3---command4---* persent更新到最前端

    在这里把单个command对象看成是一个原发器(Originator)。根据需要主动创建一个备忘录(memento)保存此刻它的内部状态,并把command对象放入历史命令记录列表。

    command基类实现：

namespace woo\command;require_once('../memento/state.php');require_once('../memento/memento.php');abstract class Command {protected $state;final function __construct(){$this->state = new \woo\memento\State();}function execute(\woo\controller\Request $request) {$this->state->set('request', $request);$this->do_execute($request);}abstract function do_execute(\woo\controller\Request $request);function do_unexecute(\woo\controller\Request $request) {}public function get_state(){return $this->state;}public function set_state(State $state){$this->state = $state;}public function get_request(){if(isset($this->state)){return $this->state->get('request');}return null;}public function set_request(\woo\controller\Request $request){if(isset($this->state)){return $this->state->set('request', $request);}}public function create_memento(){\woo\base\SessionMementoTaker::push_command($this);$mem = new \woo\memento\Memento();$mem->set_state($this->state);        return $mem;}public function set_memento(Memento $mem){$this->state = $mem->get_state();}}

    命令任务在执行开始的时候保存请求命令的参数，在命令执行过程中还可以保存其他必要的参数。由于有些命令不支持撤销操作所以在父类实现里一个空的unexecute;

    保存命令状态的对象：

class State{private $values = array();function __construct(){}public function set($key, $value){$this->values[$key] = $value;}public function get($key){if(isset($this->values[$key])){return $this->values[$key];}return null;}}

一个支持undo-redo的复制文件的命令：

namespace woo\command;require_once('request.php');require_once('command.php');require_once('../base/registry.php');require_once('../file_manager.php');require_once('../base/session_memento.php');class CopyCommand extends Command {function do_execute(\controller\Request $request) {$src_path = $request->get_property('src');$dst_path = $request->get_property('dst');$this->state->set('src_path', $src_path);$this->state->set('dst_path', $dst_path);$this->create_memento();$file_manager = \base\Registry::file_manager();$ret = $file_manager->copy($src_path, $dst_path);$request->add_feedback($ret);//...}}

    命令对象要做的工作比较单一：获取参数(校验参数)，保存必要的状态信息，把控制权交给具体的业务逻辑对象。添加执行结果并返回。不同的命令需要不同的请求参数，一些命令根本不需要也不支持撤销操作，所以可以选择性的执行create_memento操作。

    最后是要实现的undo-redo，在这里我把undo/redo也看成是一次普通的命令请求，而不需要在控制器做额外的分发处理。

撤销命令：

namespace woo\command;require_once('request.php');require_once('command.php');require_once('../base/registry.php');require_once('../base/session_memento.php');class UndoCommand extends Command{public function do_execute(\controller\Request $request){$command = \base\SessionMementoTaker::get_undo_command();if(isset($command)){$old_req = $command->get_request();$command->do_unexecute($old_req);$request->set_feedback($old_req->get_feedback());} else{$request->add_feedback('undo command not fount');}return;}}

重做命令：

namespace woo\command;require_once('request.php');require_once('command.php');require_once('../base/registry.php');class RedoCommand extends Command {public function do_execute(\woo\controller\Request $request){$command = \woo\base\SessionMementoTaker::get_redo_command();if(isset($command)){$old_req = $command->get_request();$command->do_execute($old_req);$request->set_feedback($old_req->get_feedback());} else{$request->add_feedback('undo command not fount');}return;}}

The end.