Exemple #1
0
 /**
  * @wiki /MVC模式/控制器/控制器执行
  * 
  * 控制器的执行入口是 mainRun() 方法,在你写一个控制器类的时候,应该将控制器的执行过程写在 process() 函数里,由mainRun()调用你的process()函数,而不是直接重写mainRun()。
  * process()是控制器自己的业务逻辑,mainRun()包含了很多系统级的
  * 
  * @see Controller::mainRun()
  */
 public function mainRun()
 {
     self::processController($this);
     // 处理 frame
     // (先执行自己,后执行 frame)
     if ($aFrame = $this->frame()) {
         self::processController($aFrame);
     }
     $this->response()->respond($this);
     // 触发事件
     $arrEventParams = array($this);
     EventManager::singleton()->emitEvent(__CLASS__, self::afterMainRun, $arrEventParams);
 }
Exemple #2
0
 /**
  * @wiki /MVC模式/控制器/请求-回应(request-response)
  * 
  * ===控制器 请求===
  * TODO ...
  * 
  * ===控制器 响应===
  * 控制器的执行结果如何提供给控制器的客户((^)控制器的客户(client)既可以是系统,也可以是用户),由[b]响应(Response)[/b]对像负责。
  * 
  * 在目前框架的设计中,控制器主要有三种”内容“可供输出:
  * * 控制器的消息队列
  * * 控制器的视图
  * * 控制器“放置”到[b]响应(Response)[/b]对像中的变量
  * 由[b]响应(Response)[/b]对像来决定向什么设备输出这些内容输出哪些内容。
  * 
  * [^]\
  * 在默认情况下,控制器会向系统提供一个 org\jecat\framework\mvc\controller\Response 对像做为[b]响应[/b]对像,它会将默认的输出管道做为控制器的输出设备;\
  * 并根据使用[b]请求(Request)[/b]对像中的参数决定输出策略。
  * 你也可以给控制器设置完全不同的[b]响应[/b]对像。\
  * [/^]
  * 
  * 
  * Controller类默认提供的Response对像,会根据[b]请求(Request)[/b]对像中的一些特殊参数来输出控制器的执行结果:
  * 
  * 
  * =参数 rspn=
  * rspn 参数指定了控制器向[b]响应(response)[/b]对像的输出管道,以何种形式输出何种内容。rspn参数可以是以下值:
  * * rspn=[b]msgqueue.json[/b]
  * 以json格式输出控制器消息队列中的内容
  * * rspn=[b]msgqueue.xml[/b]
  * 以xml格式输出控制器消息队列中的内容
  * * rspn=[b]msgqueue.html[/b]
  * 以html格式输出控制器消息队列中的内容
  * * rspn=[b]msgqueue[/b]
  * (和 msgqueue.html 相同)
  * * rspn=[b]var.php[/b]
  * 以php语法格式输出控制器执行后的所有结果变量					
  * * rspn=[b]var.xml[/b]
  * 以xml格式输出控制器执行后的所有结果变量
  * * rspn=[b]var.json[/b]			
  * 以json格式输出控制器执行后的所有结果变量
  * * rspn=[b]var[/b]
  * (和 var.json 相同)
  * * rspn=[b]view.noframe[/b]			
  * 禁止显示控制器 frame 部分的视图
  * * rspn=[b]noframe[/b]			
  * (和 view.noframe 相同)
  * * rspn=[b]view.inframe (默认)[/b]			
  * 在 控制器提供的frame的视图 中显示控制器的视图,这是 rspn参数的缺省值
  * * rspn=[b]inframe[/b]			
  * (和 view.inframe 相同)
  * * rspn=[b]view (默认)[/b]			
  * (和 view.inframe 相同)
  * * rspn=[b]disable[/b]			
  * 禁止输出任何内容(但不会禁止 rspn.debug.* 相关的内容)
  * 
  * [^]如果控制器中没有视图(或视图都被禁用),在 view.* 模式下,系统会输出控制器的消息队列[/^]
  * 
  * 
  * ==调式相关参数==
  * 还有一些用于调式的响应(Response)参数。
  * 
  * =参数 rspn.debug.db.log=
  * 打印整个系统在执行过程中,数据库执行SQL的情况;只要提供这个参数,等于任何值都有效。
  * 
  * =参数 rspn.debug.model.struct=
  * 打印控制器的模型结构和数据内容。
  * 该参数可以是一个表示指定模型的名称的字符串,或表示所有模型的”星号“(*)
  * 
  */
 public function respond(Controller $aController)
 {
     $aEventManager = EventManager::singleton();
     // 触发事件
     $arrEventArgvs = array($this, $aController);
     $aEventManager->emitEvent(__CLASS__, self::beforeRespond, $arrEventArgvs);
     switch ($aController->params()->get('rspn')) {
         // msgqueue ------------
         case 'msgqueue.json':
             break;
         case 'msgqueue.xml':
             break;
         case 'msgqueue':
         case 'msgqueue.html':
             $aController->messageQueue()->display(null, $this->device());
             break;
             // var ------------
         // var ------------
         case 'var':
         case 'var.json':
             $this->device()->write(json_encode($this->arrReturnVariables));
             break;
         case 'var.xml':
             break;
         case 'var.php':
             $this->device()->write(var_export($this->arrReturnVariables, true));
             break;
             // view ------------
         // view ------------
         default:
         case 'view':
         case 'view.inframe':
             if ($aFrame = $aController->frame()) {
                 $aMainView = $aFrame->mainView();
             }
             // 没有 break ,进入下面的 case
         // 没有 break ,进入下面的 case
         case 'noframe':
         case 'view.noframe':
             if (empty($aMainView)) {
                 $aMainView = $aController->mainView();
             }
             // 控制器没有有效视图
             $nValidViews = 0;
             foreach ($aController->viewIterator() as $aView) {
                 if ($aView->isEnable()) {
                     $nValidViews++;
                 }
             }
             if (!$nValidViews) {
                 // 临时提供一个仅显示消息队列的视图
                 $aTmpView = new View('tmp_view_for_msgqueue');
                 $aController->addView($aTmpView);
                 $aController->messageQueue()->display(null, $this->device());
             }
             // 装配视图
             ViewAssembler::singleton()->assemble($aController);
             // 显示视图
             $aOutput = new OutputStreamBuffer();
             $aMainView->render($aOutput);
             $this->device()->write($aOutput);
             // 触发事件
             $arrEventArgvs2 = array($this, $aMainView, $aController);
             $aEventManager->emitEvent(__CLASS__, self::afterRenderViews, $arrEventArgvs2);
             break;
         case 'disable':
             // nothing todo
             break;
     }
     // 打印数据库的执行日志
     if ($aController->params()->has('rspn.debug.db.log')) {
         $this->device()->write('<hr /><h3>数据库执行记录:</h3>');
         // 按执行时间排序
         $arrLogs = DB::singleton()->executeLog(false);
         foreach ($arrLogs as $nIdx => &$arrOneLog) {
             $arrOneLog['idx'] = $nIdx;
         }
         usort($arrLogs, function ($a, $b) {
             if ($a['time'] == $b['time']) {
                 return 0;
             }
             return $a['time'] < $b['time'] ? -1 : 1;
         });
         $fTotal = 0;
         foreach ($arrLogs as $arrLog) {
             $fTotal += $arrLog['time'];
             $this->device()->write("<div style='padding-top:10px'>[{$arrLog['idx']}]=>耗时:{$arrLog['time']} <pre>{$arrLog['sql']}</pre></div>");
         }
         $this->device()->write("\r\n<br />DB共执行了 " . count($arrLogs) . " 条SQL,总计时间:{$fTotal}\r\n<hr />");
     }
     // 打印模型结构
     if ($aController->params()->has('rspn.debug.model.struct')) {
         $sModelName = $aController->params()->get('rspn.debug.model.struct');
         $arrModelNames = array();
         if ($sModelName == '*') {
             // 控制器自己的模型
             foreach ($aController->modelNameIterator() as $sModelName) {
                 $this->device()->write('<hr /><h3>控制器' . $aController->name() . '的模型数据结构:</h3>');
                 $this->printDebugModelStruct($aController, $sModelName);
             }
             // 子控制器的模型
             foreach ($aController->iterator() as $aChildController) {
                 $this->device()->write('<hr /><h3>控制器' . $aChildController->name() . '的模型数据结构:</h3>');
                 foreach ($aChildController->modelNameIterator() as $sModelName) {
                     $this->printDebugModelStruct($aChildController, $sModelName);
                 }
             }
         } else {
             $this->device()->write('<hr /><h3>控制器' . $aController->name() . '的模型数据结构:</h3>');
             $this->printDebugModelStruct($aController, $sModelName);
         }
     }
     // 触发事件
     $aEventManager->emitEvent(__CLASS__, self::afterRespond, $arrEventArgvs);
 }
Exemple #3
0
 public function assemble(Controller $aController)
 {
     // 触发事件
     $arrEventArgvs = array($this, $aController);
     if ($return = EventManager::singleton()->emitEvent(__CLASS__, self::assemble, $arrEventArgvs)) {
         $this->arrAssemblyListRepos = $return->returnValue();
         // 			echo '<pre>' ;
         // 			print_r($return->returnValue()) ;
         // 			echo '</pre>' ;
         return;
     }
     // 正式执行操作
     foreach ($this->arrAssemblyListRepos as $sId => &$arrAssemblyList) {
         if (empty($arrAssemblyList['filter'])) {
             continue;
         }
         if (empty($arrAssemblyList['filter']['view'])) {
             throw new Exception('视图装配单缺少 view 信息。');
         }
         // echo "<br />\r\nassemble list: '", $sId, "'----------<br />\r\n" ;
         if ($arrAssemblyList['filter']['xpaths']) {
             // 使用 xpath , 从视图所属的控制器开始
             if (!($aController = $arrAssemblyList['filter']['view']->controller())) {
                 throw new Exception('视图尚未加入控制器,无法通过 xpath 查找其它视图。');
             }
             $aViewContainer = $aController->mainView();
             // 找指定 xpath 的view
             foreach ($arrAssemblyList['filter']['xpaths'] as $sXPath) {
                 if ($aFoundView = View::findXPath($aViewContainer, $sXPath)) {
                     // echo 'found view by xpath : ' , $sXPath, "<br />\r\n" ;
                     $this->assembleView($arrAssemblyList, $aFoundView);
                 }
             }
         } else {
             // 找 view 的所有下级视图
             foreach ($arrAssemblyList['filter']['view']->iterator() as $aView) {
                 if ($aView->parent() === $arrAssemblyList['filter']['view']) {
                     // echo 'found child view : ' , $aView->xpath(), "<br />\r\n" ;
                     $this->assembleView($arrAssemblyList, $aView);
                 }
             }
         }
         // 不在需要
         unset($arrAssemblyList['filter']);
     }
     // 		echo '<pre>' ;
     // 		$arrAssemblyListRepos = $this->arrAssemblyListRepos ;
     // 		foreach( $arrAssemblyListRepos as $sId=>&$arrAssemblyList )
     // 		{
     // 			if(empty($arrAssemblyList['items']))
     // 			{
     // 				//unset($arrAssemblyListRepos[$sId]) ;
     // 			}
     // 			else
     // 			{
     // 				foreach($arrAssemblyList['items'] as &$arrItem)
     // 				{
     // 					unset($arrItem['object']) ;
     // 				}
     // 			}
     // 		}
     // 		print_r($arrAssemblyListRepos) ;
     // 		echo '</pre>' ;
 }