/**
* 渲染视图，渲染后的结果(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;
}