第二十八章 基于 Smarty 的智能个体动态页面生成
- 智能个体前台页面的生成机制
- 根据对象属性组织页面内容
- 根据对象状态生成状态显示
- 根据对象方法生成操作界面
- 多对象关联页面的组织
- Smarty 模板继承与组件复用
- 智能个体页面的动态更新
第二十八章 基于 Smarty 的智能个体动态页面生成
本章研究智能个体如何根据自身结构定义、实例属性、运行状态、方法配置和对象关系,动态生成对应的前台页面。
第二十七章已经建立了智能对象运行数据与 Smarty 模板变量之间的数据映射机制,解决了后端运行数据如何组织并传递给 Smarty 的问题。本章进一步研究如何利用这些数据生成不同类型的智能个体页面,使页面结构能够随智能个体的结构定义和运行数据动态变化。
在 WSaiOS 工程体系中,页面不是智能个体本身,也不是智能结构定义。智能个体的结构和运行逻辑由 WSaiOS 后端负责,Smarty 根据后端提供的页面配置和展示数据生成前台页面。页面可以呈现对象属性、状态、方法操作和对象关系,但不承担智能个体的结构计算、认知判断和方法执行。
本章的工程目标是建立一种动态页面生成机制,使同一套页面生成程序能够服务于不同结构、不同能力和不同运行状态的智能个体,而不需要为每一个智能个体单独编写一套固定页面程序。
28.1 智能个体前台页面的生成机制
智能个体前台页面的生成,首先需要取得智能个体的结构信息和实例运行数据,再根据页面生成规则组织页面内容,最后通过 Smarty 模板解析生成 HTML 页面。
页面生成的数据来源主要包括智能个体实例、结构定义、属性配置、状态定义、方法配置、对象关系以及页面展示配置。
智能个体实例模型可以表示为:
其中,\(ID_i\) 为个体标识,\(D_i\) 为结构定义,\(T_i\) 为智能模板,\(O_i\) 为对象集合,\(P_i\) 为属性配置,\(M_i\) 为方法配置,\(S_i\) 为状态数据,\(R_i\) 为对象关系,\(K_i\) 为知识配置,\(A_i\) 为能力配置。
页面生成不需要直接使用全部结构数据,而是根据当前页面的展示要求,选择需要呈现的对象、属性、状态、操作和关系。
可以将页面生成过程表示为:
其中,\(Q_p\) 表示页面生成需求,\(C_p\) 表示页面生成约束,\(T_s\) 表示 Smarty 展示模板,\(Page_i\) 表示最终生成的页面。
这一过程可以进一步分为:
其中,\(D_i^{page}\) 是页面结构配置,\(V_i^{page}\) 是页面展示数据。页面结构配置决定页面包含哪些内容区域,展示数据提供各个区域需要显示的具体数据。
工程调用关系如下:
页面生成程序建议独立组织:
WSaiOS/
└── Presentation/
└── PageGeneration/
├── IndividualPageBuilder.php
│ // 智能个体页面生成入口,组织页面结构和展示数据
├── PageStructureResolver.php
│ // 根据智能个体结构和页面配置确定页面内容区域
├── PageComponentResolver.php
│ // 根据页面区域选择对应的Smarty展示组件
├── PageDataAssembler.php
│ // 将属性、状态、方法和关系数据组合为页面数据
├── PageTemplateResolver.php
│ // 根据页面类型和个体配置选择Smarty模板
└── PageRenderService.php
// 调用Smarty完成模板解析和页面输出
IndividualPageBuilder.php 负责组织整个页面生成过程,不直接承担具体属性读取或方法执行。PageStructureResolver.php 根据智能个体的结构定义和页面配置确定页面布局。PageComponentResolver.php 负责确定需要使用的展示组件。PageDataAssembler.php 将第二十七章的数据映射结果组织为页面所需的数据结构。PageTemplateResolver.php 选择页面模板,PageRenderService.php 调用 Smarty 输出页面。
例如,设备智能个体可以生成设备信息页面、运行监控页面和操作管理页面。虽然这些页面对应同一个智能个体,但页面内容和组件组合不同。
页面生成程序不应把设备类型写死在程序中,而应根据智能个体结构和页面配置确定展示内容。这样,新增一种智能个体时,只需要提供相应的结构定义、展示配置和必要的页面组件,就可以进入统一页面生成流程。
28.2 根据对象属性组织页面内容
智能个体由多个智能对象组成,不同对象具有不同的属性结构。页面需要根据对象实际具有的属性动态组织内容,而不能依赖固定字段。
例如,工业电机对象可能具有额定功率、额定电压、运行温度、转速和负载率等属性;机器人对象可能具有位置、速度、姿态、电量和运动范围等属性。它们的属性定义不同,但可以使用相同的动态属性页面组织机制。
设对象属性定义集合为:
实例属性值集合为:
页面展示属性集合为:
其中,\(Q_p\) 表示页面属性展示要求,\(C_p\) 表示展示条件。选择过程需要检查属性是否存在、是否具有有效值、是否允许展示,以及属性是否满足当前页面的显示条件。
属性页面可以按照属性所属对象、属性分类和展示配置组织。例如,设备详情页可以将基本信息、运行参数和维护信息分别组织为不同页面区域。
页面属性配置示例:
{
"page_id": "device_detail",
"instance_id": "motor_001",
"sections": [
{
"section_id": "basic",
"title": "基本信息",
"fields": [
"device_name",
"device_code",
"rated_power"
]
},
{
"section_id": "runtime",
"title": "运行参数",
"fields": [
"current_temperature",
"current_speed",
"load_rate"
]
}
]
}
这里的字段名称只是页面配置引用的属性标识,并不意味着系统必须预先固定这些属性。属性是否存在,仍然由对应智能对象的结构定义决定。
后端根据页面配置读取属性,并形成页面数据:
class PagePropertyAssembler
{
private $propertyReader;
public function __construct($propertyReader)
{
$this->propertyReader = $propertyReader;
}
public function build($instanceId, $sections)
{
$result = array();
foreach ($sections as $section) {
$fields = array();
foreach ($section['fields'] as $fieldId) {
$property = $this->propertyReader->read(
$instanceId,
$fieldId
);
if ($property === null) {
continue;
}
$fields[] = array(
'property_id' => $fieldId,
'name' => $property['name'],
'value' => $property['value'],
'unit' => $property['unit']
);
}
$result[] = array(
'section_id' => $section['section_id'],
'title' => $section['title'],
'fields' => $fields
);
}
return $result;
}
}
Smarty 模板根据页面数据循环生成内容:
<div class="individual-properties">
{foreach $property_sections as $section}
<section class="property-section">
<h3>{$section.title|escape}</h3>
<div class="property-list">
{foreach $section.fields as $field}
<div class="property-item">
<span>
{$field.name|escape}
</span>
<strong>
{$field.value|escape}
</strong>
<span>
{$field.unit|escape}
</span>
</div>
{/foreach}
</div>
</section>
{/foreach}
</div>
这种方式使页面内容随对象属性定义和页面配置变化。新增属性后,后端只要能够读取该属性,并且页面配置将其纳入展示范围,Smarty 就可以按照同一模板结构生成相应内容。
如果某个智能个体没有某项属性,页面生成程序应根据配置选择隐藏该字段或显示未配置状态,而不能将其他对象的属性值错误地映射过来。
对于具有大量动态属性的智能个体,还可以根据属性类型和展示配置选择不同组件,例如数值显示、文本显示、时间显示和状态参数显示。组件选择属于页面呈现规则,不应反过来改变智能对象原有属性定义。
28.3 根据对象状态生成状态显示
智能个体的运行状态会随着方法执行、外部事件、属性变化和状态转换条件而发生变化。页面需要根据当前有效状态生成对应的状态显示内容。
状态显示不是简单地读取一个状态字符串,而是根据状态定义、实例当前状态、状态来源和确认情况组织展示信息。
设智能对象状态定义为:
当前运行状态为:
页面状态数据为:
其中,\(Q_s\) 是页面状态展示配置。
例如,工业设备可能具有待机、运行、暂停、故障和维护状态。不同状态可以对应不同的文字说明、状态图标和展示区域。但这些显示内容应根据状态定义和页面配置确定,不能由 Smarty 自行判断设备是否故障。
状态显示配置示例:
{
"state_display": {
"running": {
"label": "运行中",
"component": "state_display"
},
"standby": {
"label": "待机",
"component": "state_display"
},
"fault": {
"label": "故障",
"component": "state_display"
},
"maintenance": {
"label": "维护中",
"component": "state_display"
}
}
}
后端状态数据组织程序:
class PageStateAssembler
{
private $stateReader;
public function __construct($stateReader)
{
$this->stateReader = $stateReader;
}
public function build($instanceId)
{
$state = $this->stateReader->getCurrentState(
$instanceId
);
if (!$state) {
return array(
'state_id' => 'unknown',
'state_name' => '状态未知',
'confirmed' => false
);
}
return array(
'state_id' => $state['state_id'],
'state_name' => $state['state_name'],
'confirmed' => $state['confirmed'],
'source' => $state['source'],
'updated_at' => $state['updated_at']
);
}
}
Smarty 根据已经确定的状态数据生成显示内容:
<div class="individual-state">
<span class="state-label">
{$object_state.state_name|escape}
</span>
{if !$object_state.confirmed}
<span class="state-confirmation">
状态待确认
</span>
{/if}
<span class="state-time">
{$object_state.updated_at|escape}
</span>
</div>
对于多状态智能对象,页面还可以分别展示任务状态、运行状态、通信状态和安全状态。不同状态应保留各自的定义和来源,不能将不同维度的状态简单合并成一个状态字段。
例如,机器人可能处于任务执行状态,同时处于通信中断状态。页面应当分别呈现任务执行情况和通信情况,而不是因为任务仍在执行,就认定通信正常。
状态显示的核心是:
Smarty 只根据后端传入的状态结果进行呈现。状态判断、状态转换和状态确认仍由智能对象运行程序负责。
28.4 根据对象方法生成操作界面
智能个体的方法定义和方法配置决定了对象可以通过哪些方法参与运行。前台操作界面需要根据这些方法信息动态组织,而不是为每个智能对象预先编写固定的操作按钮。
例如,工业设备智能对象可能具有启动、停止、暂停和恢复等方法;机器人智能对象可能具有移动、停止、回到指定位置和执行任务等方法。不同智能对象的方法集合不同,操作界面也应随之变化。
方法定义可以表示为:
其中,\(ID_j\) 为方法标识,\(N_j\) 为方法名称,\(P_j\) 为参数定义,\(R_j\) 为返回结果定义,\(C_j\) 为执行约束,\(H_j\) 为程序处理器映射,\(V_j\) 为方法版本。
页面操作集合为:
其中,\(U_i\) 表示当前用户权限,\(S_i\) 表示对象当前状态,\(C_i\) 表示方法执行条件。选择结果决定哪些方法可以显示,以及对应操作界面需要提供哪些参数。
例如,设备启动方法可以配置为:
{
"method_id": "start_device",
"method_name": "启动设备",
"interface": {
"component": "method_button",
"label": "启动"
},
"parameters": [],
"constraints": {
"required_state": [
"standby"
],
"permission": "device_control"
}
}
设备参数设置方法可以配置为:
{
"method_id": "set_speed",
"method_name": "设置转速",
"interface": {
"component": "method_form",
"label": "设置转速"
},
"parameters": [
{
"name": "target_speed",
"type": "number",
"unit": "r/min",
"required": true
}
],
"constraints": {
"permission": "device_control"
}
}
后端根据方法定义生成操作数据:
class PageMethodAssembler
{
private $methodResolver;
private $permissionChecker;
public function __construct(
$methodResolver,
$permissionChecker
) {
$this->methodResolver = $methodResolver;
$this->permissionChecker = $permissionChecker;
}
public function build($instanceId, $userContext)
{
$methods = $this->methodResolver->getMethods(
$instanceId
);
$result = array();
foreach ($methods as $method) {
if (!$this->permissionChecker->canInvoke(
$instanceId,
$method['method_id'],
$userContext
)) {
continue;
}
$result[] = array(
'method_id' => $method['method_id'],
'method_name' => $method['method_name'],
'interface' => $method['interface'],
'parameters' => $method['parameters']
);
}
return $result;
}
}
Smarty 可以根据方法界面类型生成不同操作组件:
<div class="individual-methods">
{foreach $object_methods as $method}
{if $method.interface.component == 'method_button'}
<form method="post" action="/object/method">
<input
type="hidden"
name="instance_id"
value="{$instance_id|escape}"
/>
<input
type="hidden"
name="method_id"
value="{$method.method_id|escape}"
/>
<button type="submit">
{$method.method_name|escape}
</button>
</form>
{elseif $method.interface.component == 'method_form'}
<div class="method-form">
<h4>{$method.method_name|escape}</h4>
{foreach $method.parameters as $parameter}
<label>
{$parameter.name|escape}
</label>
<input
type="number"
name="parameters[{$parameter.name|escape}]"
/>
{/foreach}
</div>
{/if}
{/foreach}
</div>
上述模板展示了根据方法配置生成不同操作界面的基本方式。正式工程中,方法表单还需要包含对应的提交入口、CSRF 防护、参数类型、范围和单位校验。前台提交的数据必须重新进入后端方法调用机制,不能直接调用 PHP 类中的任意方法,也不能仅凭页面按钮是否显示来判断用户是否具有执行权限。
方法调用过程应当保持以下关系:
因此,动态操作界面的本质是将智能对象已有的方法定义映射为前台操作入口。方法的实际执行仍然由 WSaiOS 运行引擎完成。
对于涉及机器人、无人机和工业设备的控制操作,还必须在后端保留设备安全约束和运行条件。页面显示一个可操作按钮,并不意味着设备在当前状态下一定允许执行该方法。
28.5 多对象关联页面的组织
一个智能个体可能由多个智能对象组成,这些对象之间通过结构关系建立联系。前台页面需要根据对象之间的组织关系,生成包含多个对象信息的页面。
例如,一个工业生产线智能个体可以包含生产线对象、控制器对象、电机对象、传感器对象和执行机构对象。每个对象都有自己的属性、状态和方法,同时通过对象关系组成一个完整的结构。
设智能个体包含的对象集合为:
对象关系集合为:
页面对象集合可以根据页面需求选择:
其中,\(Q_p\) 表示页面组织要求。页面生成程序根据对象关系确定需要展示的对象及其组织顺序,再分别读取对象属性和状态,形成多对象页面数据。
例如,生产线页面可以按照生产线与设备的包含关系组织页面结构:
{
"page_id": "production_line",
"root_instance": "line_001",
"objects": [
{
"instance_id": "motor_001",
"relation_type": "contains"
},
{
"instance_id": "sensor_001",
"relation_type": "contains"
},
{
"instance_id": "controller_001",
"relation_type": "contains"
}
]
}
上述数据描述页面所需的对象及其关系引用。实际对象信息仍需要由后端根据实例标识读取,不能将页面配置中列出的对象标识直接当作已经验证的对象数据。
多对象页面数据组织程序可以采用以下形式:
class MultiObjectPageAssembler
{
private $relationResolver;
private $objectViewBuilder;
public function __construct(
$relationResolver,
$objectViewBuilder
) {
$this->relationResolver = $relationResolver;
$this->objectViewBuilder = $objectViewBuilder;
}
public function build(
$rootInstanceId,
$userContext
) {
$relations = $this->relationResolver->getChildren(
$rootInstanceId
);
$objects = array();
foreach ($relations as $relation) {
$instanceId = $relation['target_id'];
$objectData = $this->objectViewBuilder->build(
$instanceId,
$userContext
);
if (!$objectData) {
continue;
}
$objects[] = array(
'relation_type' => $relation['relation_type'],
'object' => $objectData
);
}
return array(
'root_instance_id' => $rootInstanceId,
'objects' => $objects
);
}
}
Smarty 模板可以组织多个对象区域:
<div class="multi-object-page">
<div class="root-object">
<h2>{$root_object.name|escape}</h2>
</div>
<div class="related-objects">
{foreach $related_objects as $item}
<section class="related-object">
<h3>
{$item.object.instance.object_name|escape}
</h3>
<div class="object-state">
{$item.object.state.state_name|escape}
</div>
<div class="object-properties">
{foreach $item.object.properties as $property}
<div class="property-item">
<span>{$property.name|escape}</span>
<strong>{$property.value|escape}</strong>
</div>
{/foreach}
</div>
</section>
{/foreach}
</div>
</div>
当对象数量较多或关系结构较复杂时,页面生成程序需要控制关系查询范围,避免无边界地读取整个对象关系网络。可以根据页面层级、关系类型和用户权限确定读取范围。
对于包含关系、依赖关系和控制关系,还应当按照实际关系定义分别组织展示。不能因为两个对象同时出现在一个页面中,就将它们认定为包含关系或控制关系。
多对象页面的组织重点在于:后端依据已经定义的对象关系形成页面对象集合,Smarty 按照页面数据组织方式输出各个对象区域。
28.6 Smarty 模板继承与组件复用
智能个体类型不同,页面内容也会存在差异,但页面中仍然具有大量可以复用的结构。例如,页面头部、对象基本信息、属性列表、状态显示、方法操作区域和关系展示区域,都可以组织为可复用的 Smarty 模板组件。
Smarty 的模板继承和模板包含机制可以用于组织这些页面结构。
这里需要明确:Smarty 模板继承解决的是页面布局和展示结构复用问题,不是智能模板之间的结构继承。智能模板继承由 WSaiOS 智能模板管理机制负责,Smarty 模板继承只处理页面模板之间的关系。
页面模板可以采用基础模板和个体页面模板相结合的方式。
建议目录组织如下:
templates/
└── individual/
├── layout/
│ ├── base.tpl
│ │ // 智能个体页面的基础布局模板
│ └── dashboard.tpl
│ // 智能个体监控页面的布局模板
│
├── components/
│ ├── object_header.tpl
│ │ // 智能对象名称、标识和类型展示组件
│ ├── property_list.tpl
│ │ // 动态对象属性列表组件
│ ├── state_display.tpl
│ │ // 对象当前状态展示组件
│ ├── method_panel.tpl
│ │ // 对象方法操作区域组件
│ └── relation_list.tpl
│ // 对象关联关系展示组件
│
├── device/
│ ├── detail.tpl
│ │ // 工业设备智能个体详情页面
│ └── monitor.tpl
│ // 工业设备智能个体运行监控页面
│
└── robot/
├── detail.tpl
│ // 机器人智能个体详情页面
└── monitor.tpl
// 机器人智能个体运行监控页面
基础页面模板可以组织公共页面区域:
{block name="page_content"}
<div class="individual-page">
{block name="individual_content"}{/block}
</div>
{/block}
具体页面继承基础模板:
{extends file="individual/layout/base.tpl"}
{block name="individual_content"}
{include file="individual/components/object_header.tpl"}
{include file="individual/components/property_list.tpl"}
{include file="individual/components/state_display.tpl"}
{include file="individual/components/method_panel.tpl"}
{include file="individual/components/relation_list.tpl"}
{/block}
上述代码体现了基础页面与具体页面之间的继承关系,以及页面组件的复用方式。不同类型的智能个体可以使用相同的属性组件和状态组件,但根据各自结构配置选择不同的数据内容。
对于机器人页面,可能需要额外的姿态、位置和运动状态展示组件;对于工业设备页面,可能需要增加温度、转速和负载率等展示区域。新增组件只扩展页面呈现能力,不需要改变智能对象原有的结构定义和运行机制。
模板选择程序应当根据页面配置和允许使用的模板路径进行选择:
class PageTemplateResolver
{
public function resolve($pageConfig)
{
if (
empty($pageConfig['template'])
) {
return 'individual/layout/base.tpl';
}
return $pageConfig['template'];
}
}
正式工程中,模板路径还应通过模板注册配置进行约束,不能直接将用户提交的任意字符串作为模板文件路径使用。
模板复用关系可以表示为:
其中,\(T_{base}\) 是基础页面模板,\(T_{component}\) 是公共展示组件,\(T_{individual}\) 是智能个体类型对应的页面模板。
由此可以形成统一的页面结构,同时允许不同智能个体根据自身结构进行页面差异化组织。
28.7 智能个体页面的动态更新
智能个体页面生成后,页面展示内容并不是永久固定的。随着实例属性、运行状态、方法执行结果和对象关系发生变化,前台页面需要同步更新相应内容。
动态更新的关键是根据实例运行数据变化确定需要更新的页面区域,而不是每次都重新生成整个页面。
设实例在时间 \(t\) 的运行数据为:
当实例数据发生变化时:
后端根据变化内容确定页面更新集合:
其中,\(U_i\) 表示需要更新的页面区域,\(Q_p\) 表示当前页面配置。
例如,设备当前温度发生变化,只需要更新温度属性展示区域;设备状态从待机变为运行,需要更新状态区域;设备方法执行结果返回,需要更新方法执行结果区域;对象关系发生变化,则需要重新组织相关对象区域。
这种方式可以减少无关页面内容的重复生成。
页面动态更新程序建议组织如下:
WSaiOS/
└── Presentation/
└── PageUpdate/
├── PageUpdateService.php
│ // 根据实例运行数据变化组织页面更新
├── PageChangeDetector.php
│ // 判断属性、状态、方法结果和关系数据的变化
├── PageRegionResolver.php
│ // 根据变化内容确定需要更新的页面区域
├── PageUpdateDataBuilder.php
│ // 重新组织发生变化的页面区域数据
└── PageUpdateVersionManager.php
// 管理页面数据版本并识别过期更新
页面变化识别可以表示为:
页面区域映射为:
这里的 \(U_P\)、\(U_S\)、\(U_M\) 和 \(U_R\) 分别表示属性、状态、方法结果和对象关系对应的页面更新区域。页面结构或展示配置发生变化时,可能需要重新组织整个页面。
后端更新服务示例:
class PageUpdateService
{
private $changeDetector;
private $regionResolver;
private $dataBuilder;
public function __construct(
$changeDetector,
$regionResolver,
$dataBuilder
) {
$this->changeDetector = $changeDetector;
$this->regionResolver = $regionResolver;
$this->dataBuilder = $dataBuilder;
}
public function update(
$instanceId,
$oldData,
$newData,
$pageConfig
) {
$changes = $this->changeDetector->detect(
$oldData,
$newData
);
if (empty($changes)) {
return array(
'updated' => false,
'regions' => array()
);
}
$regions = $this->regionResolver->resolve(
$changes,
$pageConfig
);
$updateData = $this->dataBuilder->build(
$instanceId,
$regions
);
return array(
'updated' => true,
'regions' => $regions,
'data' => $updateData
);
}
}
页面更新数据可以通过 HTTP 请求返回给前台,再由页面脚本更新相应区域。Smarty 仍然负责初次页面生成;后续局部更新可以使用后端返回的数据更新页面区域,也可以在需要重新生成模板片段时,由 PHP 调用 Smarty 重新解析对应模板。
动态更新流程如下:
页面更新方式可以根据工程环境选择。普通管理页面可以通过用户主动刷新或定时请求取得最新数据;持续监控页面可以采用服务端推送或其他实时通信机制;本地独立运行的智能个体可以直接从本地运行服务取得更新数据。
无论采用哪种方式,都必须区分页面更新时间和对象真实状态更新时间。页面刷新成功,只说明展示数据已经重新获取,不代表设备状态一定发生了变化。对于通信中断的对象,页面还需要明确显示最后一次有效数据的更新时间和通信状态,避免将历史数据误认为实时数据。
此外,动态页面更新还应处理并发和版本问题。多个更新请求同时到达时,应检查实例标识、页面数据版本和运行数据版本,避免旧数据覆盖新数据。对于对象关系和页面结构变化,还需要重新检查页面访问权限和展示范围。
本章建立的动态页面生成机制,最终形成以下工程过程:
通过这一机制,同一套页面生成程序可以根据不同智能个体的属性、状态、方法和对象关系生成不同页面。智能个体的结构变化可以带动页面内容变化,运行数据变化可以带动页面局部更新,而 Smarty 始终保持页面呈现工具的职责边界。
本章与第二十七章的区别在于: 第二十七章解决智能对象数据如何映射为 Smarty 变量,第二十八章解决这些变量如何参与页面结构组织、组件选择、页面生成和动态更新。下一章将进一步研究智能个体可视化编辑与交互,重点处理用户通过前台界面对智能对象结构配置、属性数据和操作内容进行编辑时,如何与后端智能构建及运行机制建立对应关系。


