/** * 渲染视图,渲染后的结果(html)将输出到 $aDevice 参数中 * @see org\jecat\framework\mvc\view.IView::render() */ public function render(IOutputStream $aDevice) { if (!$this->bEnable) { return; } if ($this->aTemplateCompiledFile) { // render myself $aVars = $this->variables(); $aVars->set('theView', $this); $aVars->set('theModel', $this->model()); $aVars->set('theController', $this->aController); if ($this->aController) { $aVars->set('theParams', $this->aController->params()); } // debug模式下,输出模板文件的路径 if (Application::singleton()->isDebugging()) { if (!($aUI = $this->ui())) { throw new Exception("无法取得 UI 对像。"); } $aSrcMgr = $aUI->sourceFileManager(); list($sNamespace, $sSourceFile) = $aSrcMgr->detectNamespace($this->template()); if ($aTemplateFile = $aSrcMgr->find($sSourceFile, $sNamespace)) { $sSourcePath = $aTemplateFile->path(); } else { $sSourcePath = "can not find template file: {$sNamespace}:{$sSourceFile}"; } $aDevice->write("\r\n\r\n<!-- Template: {$sSourcePath} -->\r\n"); } // render $this->ui()->render($this->aTemplateCompiledFile, $aVars, $aDevice, false, true); } // 显示流浪视图 if ($this->sVagrantViewsAssemlyListId) { ViewAssembler::singleton()->displayAssemblyList($this->sVagrantViewsAssemlyListId, $aDevice); } $this->bRendered = true; }
/** * @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); }
public function compile(IObject $aObject, ObjectContainer $aObjectContainer, TargetCodeOutputStream $aDev, CompilerManager $aCompilerManager) { Assert::type("org\\jecat\\framework\\ui\\xhtml\\Node", $aObject, 'aObject'); $aAttrs = $aObject->attributes(); // 指定view名称 if ($aAttrs->has('xpath')) { $sXpath = $aAttrs->get('xpath'); } else { if ($aAttrs->has('name')) { $sXpath = $aAttrs->get('name'); } else { $sXpath = null; } } if ($sXpath) { $arrViewXPaths = "array({$sXpath})"; $bUseXpath = true; } else { $arrViewXPaths = 'null'; $bUseXpath = false; } $sLayout = $aAttrs->string('layout') ?: ViewAssembler::layout_vertical; // model if ($aAttrs->has('mode')) { $nMode = ViewAssembler::filterModeToPriority($aAttrs->string('mode')); } else { $nMode = $bUseXpath ? ViewAssembler::hard : ViewAssembler::soft; } $nNodeViewId =& $aDev->properties(true)->getRef('node.view.id'); if ($nNodeViewId === null) { $nNodeViewId = 0; } else { $nNodeViewId++; } $sViewAssemblyListId = "\$this->id().'-pos{$nNodeViewId}'"; // 视图的预处理 $aDev->preprocessStream()->write("\r\n// define view assembly list -------------------"); $aDev->preprocessStream()->write("if( empty(\$this) or !(\$this instanceof jc\\mvc\\view\\IView) )"); $aDev->preprocessStream()->write("{"); $aDev->preprocessStream()->write("\tthrow new jc\\lang\\Exception('UI标签 <view> 必须用于视图类。') ;"); $aDev->preprocessStream()->write("}"); $aDev->preprocessStream()->write("jc\\mvc\\view\\ViewAssembler::singleton()->defineAssemblyList(\r\n\t\t{$sViewAssemblyListId}\r\n\t\t, '{$sLayout}'\r\n\t\t, array(\r\n\t\t\t'priority' => {$nMode},\r\n\t\t\t'xpaths' => {$arrViewXPaths},\r\n\t\t\t'view' => \$this ,\r\n\t\t)\r\n) ;"); $aDev->write("\r\n// display views "); $sViewAssemblyListId = "\$aVariables->theView->id().'-pos{$nNodeViewId}'"; $aDev->write("jc\\mvc\\view\\ViewAssembler::singleton()->displayAssemblyList({$sViewAssemblyListId},\$aDevice) ;"); return; }