重做(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的實現是基於先前實現的一個會話（URL 註冊機制）。根據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的複製檔案的指令：指令物件要做的工作比較單一：取得參數(校驗參數)，保存必要的狀態訊息，把控制權交給具體的業務邏輯物件。新增執行結果並返回。不同的指令需要不同的請求參數，有些指令根本不需要也不支援撤銷操作，所以可以選擇性的執行create_memento操作。

    最後是要實現的undo-redo，在這裡我把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);
		//...
	}
}

重做指令：

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;
	}
}

以上就介紹了重做(redo)和撤銷(undo)的完整實現，包括了方面的內容，希望對PHP教程有興趣的朋友有所幫助。