第六篇 智能实例运行与 Smarty 动态呈现
第二十六章 智能对象实例的运行机制
- 智能实例的加载与初始化
- 实例运行上下文
- 实例属性读取与修改
- 实例方法调用与返回
- 实例状态变化与保存
- 多实例运行与资源管理
- 实例运行异常与恢复
第二十六章 智能对象实例的运行机制
智能对象实例的运行机制,是 WSaiOS 将已经构建、实例化并完成知识与能力配置的智能对象,加载到实际运行环境中,使其能够依据自身结构定义、属性数据、方法配置、状态条件和对象关系开展独立运行的工程过程。
前面章节已经完成了智能对象结构定义、动态属性与属性值管理、动态方法与程序绑定、对象状态与动态变化、对象关系与结构组合、智能模板构建、个体实例化,以及知识、能力和智能逻辑配置。经过这些工程过程,智能个体已经具备了运行所需要的结构基础。本章研究的重点,是如何将这些已经建立的数据和程序关系组织为实际运行过程。
智能对象实例不是一个单纯的数据记录,也不是一个只包含属性和方法名称的程序对象。它是以结构定义为基础,通过实例属性赋值、方法处理器绑定、知识能力配置、状态初始化和运行约束组织起来的独立运行对象。
在运行过程中,系统需要根据实例标识加载对应的结构版本和实例数据,建立运行上下文,读取和修改实例属性,调用已经注册的方法处理器,处理方法返回结果,更新对象状态,并将运行结果持久化。多个实例同时运行时,还需要保证实例之间的数据隔离、资源分配和运行状态独立。
本章围绕智能对象实例的加载与初始化、运行上下文、属性读取与修改、方法调用与返回、状态变化与保存、多实例运行与资源管理,以及运行异常与恢复,建立智能实例运行引擎的工程实现机制。
26.1 智能实例的加载与初始化
智能实例的加载,是运行引擎根据实例标识读取对应的个体结构、结构定义、属性值、方法配置、知识能力和初始状态,并将这些数据组织为可以运行的实例对象的过程。
实例运行不能只读取一个实例数据表。因为智能个体的运行基础分布在结构定义、实例配置、知识数据、能力配置和方法注册等不同数据体系中。运行引擎必须按照实例与结构之间的关联关系,依次加载必要的数据。
智能实例的基本运行数据可以表示为:
其中,\(ID_i\) 表示实例标识,\(D_i\) 表示结构定义,\(T_i\) 表示智能模板来源,\(P_i\) 表示实例属性,\(M_i\) 表示实例方法配置,\(S_i\) 表示实例状态,\(R_i\) 表示对象关系,\(K_i\) 表示知识配置,\(A_i\) 表示能力配置,\(C_i\) 表示运行约束,\(V_i\) 表示相关版本信息。
加载过程首先通过 instance_id 查找实例主体记录,再读取该实例所引用的结构标识和结构版本。随后加载结构元素、属性定义、方法定义、状态定义、关系定义以及实例对应的属性值和方法配置。最后检查知识引用、能力配置、运行权限和方法处理器是否满足初始化条件。
实例加载过程可以表示为:
其中,\(E_r\) 表示目标运行环境,包含程序版本、必要资源、运行权限和外部设备接口等条件。
加载程序不能直接使用当前最新结构定义覆盖实例原有结构。实例必须依据自身记录的结构版本加载,确保实例属性、方法配置和状态定义与对应版本保持一致。若结构版本已经失效或存在不兼容变化,应当进入兼容性检查或迁移流程,而不是强制加载。
智能实例初始化可以组织为以下流程:
初始化过程需要区分结构定义中的初始状态与实例运行时的当前状态。结构定义可以规定实例创建时的默认状态,但设备或现实对象当前处于什么状态,应当根据真实反馈或有效数据确定,不能简单地把结构定义中的默认状态当作现实运行状态。
例如,工业电机结构定义可以规定初始状态为 UNKNOWN,实例初始化时根据控制器和传感器反馈确认实际状态。如果没有获得有效反馈,就应保留未知状态,而不是自动设置为停止或运行。
工程上建议建立实例加载程序和初始化程序两个职责不同的组件。
WSaiOS/
└── Runtime/
├── Loader/
│ ├── InstanceLoader.php
│ │ 功能:根据实例标识读取实例主体记录、结构引用和实例配置,组织完整的加载数据。
│ ├── StructureLoader.php
│ │ 功能:按照实例指定的结构版本加载对象、属性、方法、状态及关系定义。
│ ├── KnowledgeLoader.php
│ │ 功能:读取实例关联的知识结构及其版本,检查知识引用是否有效。
│ └── CapabilityLoader.php
│ 功能:加载实例能力配置,检查能力所引用的方法、知识和运行条件。
│
├── Initialization/
│ ├── InstanceInitializer.php
│ │ 功能:组织实例初始化过程,检查各类加载数据是否完整。
│ ├── PropertyInitializer.php
│ │ 功能:依据属性定义和实例配置建立初始属性值。
│ ├── StateInitializer.php
│ │ 功能:建立实例初始状态,并区分默认状态与实际运行状态。
│ └── RuntimeEnvironmentChecker.php
│ 功能:检查运行程序版本、资源、权限及必要外部接口是否满足要求。
│
└── InstanceRuntime.php
功能:作为实例运行入口,调用加载、初始化和运行上下文建立程序。
InstanceLoader.php 负责读取和组织实例运行所需的数据,不负责执行对象方法;StructureLoader.php 负责读取结构定义,不负责修改结构版本;InstanceInitializer.php 负责组织初始化过程,不负责替代运行引擎执行持续运行任务。
实例加载和初始化完成后,运行引擎才可以将其登记为可运行实例。对于初始化失败的实例,应保存失败阶段、失败原因和相关版本信息,不能将未完成初始化的实例登记为正常运行状态。
26.2 实例运行上下文
实例运行上下文是智能对象实例在某一次运行过程中所使用的数据、状态、权限、方法调用信息和资源信息的集合。它为实例提供独立的运行环境,使运行引擎能够明确当前正在处理哪个实例、使用哪个结构版本、读取哪些属性、调用哪些方法,以及当前运行处于什么状态。
智能实例虽然可以共享同一结构定义和运行引擎,但不同实例必须具有独立的运行上下文。一个实例的属性修改、状态变化和方法执行结果,不应当因为共享同一模板或结构定义而自动影响其他实例。
运行上下文可以表示为:
其中,\(ID_i\) 表示实例标识,\(D_v\) 表示实例使用的结构版本,\(P_i\) 表示当前属性数据,\(S_i\) 表示当前状态,\(K_i\) 表示知识配置,\(A_i\) 表示能力配置,\(M_i\) 表示方法配置,\(R_i\) 表示对象关系,\(E_i\) 表示运行环境,\(T_i\) 表示运行时间信息,\(Q_i\) 表示本次运行的权限和资源约束。
运行上下文不是结构定义本身,也不是永久保存的实例数据副本。它是在实例运行期间形成的执行环境,既可以包含从数据库加载的数据,也可以包含本次运行产生的临时变量、方法调用记录、计算结果和事件信息。
例如,工业电机实例运行时,上下文需要包含实例标识、结构版本、当前温度、运行状态、启动方法配置、温度判断知识、运行权限以及当前任务信息。当启动方法被调用时,方法执行程序从上下文中读取必要参数,完成处理后将结果返回给运行引擎,再由运行引擎决定是否更新属性和状态。
实例运行上下文的建立过程可以组织为:
程序实现中,运行上下文可以封装为独立的 PHP 类:
class InstanceRuntimeContext
{
protected $instanceId;
protected $structureVersion;
protected $properties;
protected $states;
protected $methods;
protected $knowledge;
protected $capabilities;
protected $relations;
protected $environment;
protected $runtimeStatus;
public function __construct($data)
{
$this->instanceId = $data['instance_id'];
$this->structureVersion = $data['structure_version'];
$this->properties = $data['properties'];
$this->states = $data['states'];
$this->methods = $data['methods'];
$this->knowledge = $data['knowledge'];
$this->capabilities = $data['capabilities'];
$this->relations = $data['relations'];
$this->environment = $data['environment'];
$this->runtimeStatus = 'INITIALIZED';
}
public function getInstanceId()
{
return $this->instanceId;
}
public function getProperty($propertyId)
{
return isset($this->properties[$propertyId])
? $this->properties[$propertyId]
: null;
}
public function getState($stateId)
{
return isset($this->states[$stateId])
? $this->states[$stateId]
: null;
}
public function getMethod($methodId)
{
return isset($this->methods[$methodId])
? $this->methods[$methodId]
: null;
}
public function getRuntimeStatus()
{
return $this->runtimeStatus;
}
public function setRuntimeStatus($status)
{
$this->runtimeStatus = $status;
}
}
该类负责保存一次实例运行所需的上下文数据。实际工程中,属性读取和修改还需要通过属性管理服务完成,方法调用需要经过方法执行器,状态变化需要经过状态转换程序。运行上下文不应当直接绕过这些管理程序修改数据库。
对于运行时间较长的智能个体,还需要区分长期运行上下文和单次任务上下文。长期运行上下文保存实例当前有效的结构和运行状态;单次任务上下文保存某次任务的输入、执行步骤、临时数据和执行结果。任务结束后,临时数据可以释放,但已经确认的实例属性和状态变化应当按照持久化规则保存。
26.3 实例属性读取与修改
实例属性是智能对象运行过程中用于描述对象自身特征、运行参数、配置数据和当前状态相关信息的数据基础。
在前面动态属性管理章节中,已经建立了属性定义与属性值分离的组织方式。运行阶段需要在此基础上实现属性读取、属性赋值、属性修改和属性持久化,使方法执行、结构计算、状态判断和对象认知能够获得有效的属性数据。
实例属性读取必须先依据实例标识确定目标实例,再依据属性标识读取对应属性值,同时检查属性定义、属性类型、当前值来源和有效状态。
属性读取可以表示为:
其中,\(O_i\) 表示目标实例,\(P_j\) 表示属性定义,\(C_i\) 表示当前运行上下文,\(V_{ij}\) 表示读取结果。
属性修改可以表示为:
其中,\(X_j\) 表示新的属性值,\(C_u\) 表示属性更新约束。更新程序需要检查属性是否允许修改、数据类型是否一致、数值范围是否有效,以及当前实例是否具有修改权限。
属性值修改不能直接修改结构定义。结构定义规定属性的名称、类型、单位和约束,实例属性值则表示某个具体对象在当前运行过程中的实际数据。修改一个电机实例的温度值,不会改变电机结构定义中的温度属性;修改一个机器人实例的速度配置,也不应自动改变其他机器人实例的属性值。
例如,工业电机实例的属性数据可以组织为:
{
"instance_id": "motor_instance_001",
"structure_version": "1.0",
"properties": [
{
"property_id": "rated_power",
"value": 15,
"unit": "kW",
"value_source": "confirmed_configuration"
},
{
"property_id": "operating_temperature",
"value": 68,
"unit": "℃",
"value_source": "sensor_feedback"
},
{
"property_id": "rotation_speed",
"value": 1450,
"unit": "r/min",
"value_source": "controller_feedback"
}
]
}
运行引擎读取属性时,应当通过统一的属性访问服务完成。对于来自传感器、控制器或多模态认知系统的更新数据,还需要保留原始来源和采集时间,不能将不同来源的数据混为一类。
属性读取与修改程序可以组织为:
WSaiOS/
└── Runtime/
└── Property/
├── RuntimePropertyReader.php
│ 功能:根据实例标识和属性标识读取当前有效属性值,并返回属性定义及来源信息。
├── RuntimePropertyUpdater.php
│ 功能:处理运行期间的属性修改请求,检查修改权限、实例状态和属性约束。
├── RuntimePropertyValidator.php
│ 功能:验证属性数据类型、取值范围、单位及属性之间的约束关系。
└── RuntimePropertyRepository.php
功能:负责实例属性值的数据库读取、写入及历史记录访问。
属性读取程序与属性更新程序应当共享属性定义和验证规则,但不应混合各自职责。读取程序不修改数据,更新程序不自行定义属性,验证程序不直接执行数据库写入。
属性更新过程如下:
对于频繁变化的运行属性,还需要考虑数据更新频率和持久化策略。例如,设备传感器可能以较高频率产生数据,运行引擎可以先在内存上下文中处理实时数据,再根据数据类型、保存策略和运行要求批量持久化。对于需要立即保存的关键状态和控制反馈,则不能为了减少数据库写入而任意延迟。
实例属性更新还应当支持并发控制。两个运行任务同时修改同一属性时,需要通过版本号、更新时间或事务锁定机制避免后写入的数据无条件覆盖先写入的数据。对于不同来源的数据,应当依据属性更新规则判断是否允许覆盖,而不是简单采用最后写入者优先。
26.4 实例方法调用与返回
智能对象实例的方法调用,是运行引擎根据实例当前需求和运行条件,选择实例已经配置的方法,通过方法注册机制找到对应的实际程序处理器,传入必要参数并执行,最后接收返回结果的过程。
在动态方法与程序绑定机制中,方法定义与实际 PHP 程序已经分离。方法定义负责说明方法标识、参数、返回值、执行条件和权限要求;程序处理器负责完成实际运算或操作。运行阶段不能根据方法名称直接执行任意程序代码,而应当通过经过注册和验证的方法处理器完成调用。
实例方法调用可以表示为:
其中,\(O_i\) 表示目标实例,\(M_j\) 表示方法定义,\(H_k\) 表示已注册的实际处理器,\(P\) 表示调用参数,\(C_i\) 表示实例运行上下文,\(R_m\) 表示方法返回结果。
例如,工业电机实例配置了启动方法。运行引擎收到启动请求后,需要检查实例是否存在、方法是否已经配置、当前状态是否允许启动、调用者是否具备权限,以及启动方法所需参数是否完整。只有通过这些检查,才能调用已经注册的启动处理器。
方法配置可以组织为:
{
"instance_id": "motor_instance_001",
"methods": [
{
"method_id": "motor_start",
"method_version": "1.0",
"handler": "IndustrialMotorHandler::start",
"parameters": {
"target_speed": 1450
},
"permission": "motor_control",
"execution_condition": {
"required_state": "STOPPED"
}
}
]
}
这里的 handler 是经过程序注册的处理器标识,不是可以直接执行的任意字符串。方法执行引擎必须通过安全注册表查询实际处理器,并检查方法定义版本与处理器版本是否兼容。
方法调用程序组织如下:
WSaiOS/
└── Runtime/
└── Method/
├── RuntimeMethodResolver.php
│ 功能:依据实例方法配置读取方法定义、方法版本和处理器映射。
├── RuntimeMethodRegistry.php
│ 功能:维护已经注册和验证的实际方法处理器,提供安全的处理器查询。
├── RuntimeMethodExecutor.php
│ 功能:检查调用条件、组织参数、调用处理器并接收执行结果。
├── RuntimeParameterValidator.php
│ 功能:验证方法参数的类型、范围、完整性及参数之间的约束。
└── RuntimeResultHandler.php
功能:组织方法返回结果,区分调用接受、程序执行和实际效果确认。
方法调用流程如下:
方法执行可以通过 PHP 类实现:
class RuntimeMethodExecutor
{
protected $methodResolver;
protected $methodRegistry;
protected $parameterValidator;
public function __construct(
$methodResolver,
$methodRegistry,
$parameterValidator
) {
$this->methodResolver = $methodResolver;
$this->methodRegistry = $methodRegistry;
$this->parameterValidator = $parameterValidator;
}
public function execute($context, $methodId, $parameters)
{
$method = $this->methodResolver->resolve(
$context->getInstanceId(),
$methodId
);
if (!$method) {
return array(
'status' => 'METHOD_NOT_FOUND'
);
}
$handler = $this->methodRegistry->getHandler(
$method['handler_id']
);
if (!$handler) {
return array(
'status' => 'HANDLER_NOT_REGISTERED'
);
}
if (!$this->parameterValidator->validate(
$method,
$parameters
)) {
return array(
'status' => 'INVALID_PARAMETERS'
);
}
try {
return $handler->execute(
$context,
$parameters
);
} catch (Exception $e) {
return array(
'status' => 'EXECUTION_FAILED',
'message' => $e->getMessage()
);
}
}
}
实际工程中还需要在处理器调用之前执行权限验证、状态条件验证、资源检查和方法版本兼容性检查。对于外部设备控制方法,还必须检查设备驱动、通信接口和本地安全条件。
方法返回结果需要明确区分不同含义。程序接收调用请求,不代表方法已经执行;程序执行成功,不代表外部设备已经完成动作;控制指令已经发送,也不代表现实对象已经达到目标状态。
因此,方法返回结果可以组织为:
{
"instance_id": "motor_instance_001",
"method_id": "motor_start",
"call_id": "call_20261116001",
"result": {
"accepted": true,
"executed": true,
"confirmed": false,
"output": {
"command": "START",
"target_speed": 1450
}
},
"status": "WAITING_FOR_FEEDBACK"
}
对于不涉及外部设备的纯计算方法,程序返回结果经过计算规则验证后可以直接进入后续处理;对于设备控制方法,则需要根据设备反馈或其他有效证据确认实际执行效果。
方法返回结果交由运行引擎统一处理。运行引擎根据结果决定是否更新属性、触发状态转换、记录执行历史或启动后续方法。方法处理器不应当绕过运行引擎直接修改实例的全部运行数据。
26.5 实例状态变化与保存
智能对象实例的状态变化,是实例在初始化、方法执行、属性变化、外部事件和运行条件变化过程中,依据状态定义和转换规则形成新的运行状态的过程。
状态定义属于对象结构,状态当前值属于实例数据。多个实例可以共享同一套状态定义,但各自拥有独立的当前状态和状态历史。
实例状态可以表示为:
其中,\(S_i(t)\) 表示实例当前状态,\(E_i(t)\) 表示触发状态判断的事件,\(P_i(t)\) 表示当前相关属性值,\(C_i\) 表示状态转换约束,\(S_i(t+1)\) 表示经过判断后的新状态。
例如,工业电机实例可能具有停止、启动中、运行、停止中、故障和未知等状态。启动方法被调用后,实例可以进入启动中状态;控制器反馈运行成功后,才可以更新为运行状态。如果启动指令已经发送但没有收到设备反馈,就不能直接将实例状态设置为运行。
状态变化必须依据状态定义中的合法转换关系。对于不允许的转换,应当拒绝状态更新并保留原因。对于状态信息不足的情况,应当保留未知或待确认结果,而不是自动选择一个看似合理的状态。
状态变化程序组织如下:
WSaiOS/
└── Runtime/
└── State/
├── RuntimeStateReader.php
│ 功能:读取实例当前状态、状态定义和状态版本。
├── RuntimeStateEvaluator.php
│ 功能:根据当前属性、事件和运行条件判断状态转换是否成立。
├── RuntimeStateTransition.php
│ 功能:执行合法状态转换,检查转换条件和状态约束。
├── RuntimeStatePersistence.php
│ 功能:保存实例当前状态和状态变化历史。
└── RuntimeStateHistory.php
功能:查询状态变化记录,提供状态追溯和运行分析所需的数据。
状态变化与保存的流程如下:
状态变化程序需要与属性管理程序和方法执行程序保持明确的数据关系。方法执行结果可以成为状态变化事件,属性变化也可以触发状态重新判断,但状态变化仍然需要通过状态转换规则验证,不能由某个方法随意修改所有状态。
实例当前状态和状态历史应当分开保存。当前状态用于运行引擎快速读取,历史记录用于追踪对象运行过程。
建议沿用前面章节建立的实例状态管理体系,使用独立的当前状态表和历史表。例如:
CREATE TABLE ws_runtime_instance_state (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
instance_id VARCHAR(64) NOT NULL,
state_id VARCHAR(64) NOT NULL,
state_value VARCHAR(64) NOT NULL,
state_version INT NOT NULL DEFAULT 1,
source_type VARCHAR(32) DEFAULT NULL,
source_id VARCHAR(64) DEFAULT NULL,
updated_at DATETIME NOT NULL,
UNIQUE KEY uk_instance_state (
instance_id,
state_id
)
);
CREATE TABLE ws_runtime_state_history (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
instance_id VARCHAR(64) NOT NULL,
state_id VARCHAR(64) NOT NULL,
old_value VARCHAR(64) DEFAULT NULL,
new_value VARCHAR(64) NOT NULL,
event_id VARCHAR(64) DEFAULT NULL,
method_call_id VARCHAR(64) DEFAULT NULL,
source_type VARCHAR(32) DEFAULT NULL,
source_id VARCHAR(64) DEFAULT NULL,
created_at DATETIME NOT NULL,
KEY idx_instance_state_time (
instance_id,
state_id,
created_at
)
);
这里的表结构是运行状态持久化设计示例。若项目已经具有对应的实例状态表,应在既有数据模型上扩展必要的运行字段,而不是重复创建功能相同的表。
状态保存时应使用数据库事务,确保当前状态更新与状态历史写入保持一致。对于多个任务同时修改同一个实例状态的情况,还需要进行版本检查,防止状态记录发生并发覆盖。
26.6 多实例运行与资源管理
WSaiOS 的智能个体构建体系允许同一智能模板生成多个不同实例,也允许不同结构类型的实例使用统一运行引擎。因此,运行阶段必须支持多个实例同时加载、独立执行和资源管理。
多实例运行的核心不是为每个实例复制一套完整的运行程序,而是由统一运行引擎加载不同实例的结构数据和运行上下文,根据各自的属性、方法、知识、能力和状态配置执行不同任务。
设运行环境中存在多个实例:
每个实例具有独立运行上下文:
运行引擎统一管理实例加载和执行过程,但必须保证:
这里的独立性主要指实例私有运行数据、属性修改、状态数据和任务执行上下文不能未经授权相互覆盖,并不表示实例之间不能存在业务关系或结构关系。共享结构定义、公共知识和公共运行服务可以按照明确的引用和权限规则使用。
多实例运行架构可以组织为:
多实例运行需要建立实例运行管理器,负责实例登记、运行状态查询、任务分配和资源统计。运行引擎负责执行具体实例的运行逻辑,资源管理程序负责管理 CPU、内存、数据库连接、文件句柄、网络连接和设备接口等资源。
程序目录可以组织为:
WSaiOS/
└── Runtime/
└── Manager/
├── InstanceRuntimeManager.php
│ 功能:统一管理实例运行登记、加载请求、运行状态和实例停止操作。
├── RuntimeScheduler.php
│ 功能:依据任务优先级、实例运行条件和资源情况安排运行任务。
├── RuntimeResourceManager.php
│ 功能:管理运行实例占用的内存、数据库连接、设备接口及其他运行资源。
├── InstanceIsolationManager.php
│ 功能:保证不同实例的私有数据、运行上下文和权限边界相互隔离。
└── RuntimeMonitor.php
功能:监测实例运行状态、资源使用、任务执行情况和运行异常。
实例运行管理器不能把所有实例数据放在同一个可任意修改的共享对象中。每个实例应当拥有独立上下文,并通过实例标识访问对应的数据。对于共享知识、公共方法和公共结构定义,可以使用引用方式加载,但不能因此使一个实例的私有属性或状态自动传播到其他实例。
多实例运行还需要处理资源竞争。例如,多个实例同时请求同一个设备接口、文件资源或数据库连接时,运行引擎需要根据资源类型和使用约束决定执行顺序。对于不可同时操作的设备,应当通过资源锁定和任务队列避免多个实例同时发出冲突指令。
对于通信模式运行,中央控制系统可以向多个实例分配任务、获取运行状态和组织协同;对于非通信模式运行,实例需要在本地运行环境中完成必要的任务处理和安全约束检查。通信中断时,不能依赖中央控制系统实时分配每一个运行步骤,也不能假定中央系统能够立即获取本地实例的状态变化。
多实例运行资源管理还应当考虑运行任务结束后的资源释放。临时上下文、计算缓存、文件资源和连接资源应当按照生命周期释放;需要长期保留的属性值、状态记录、执行结果和证据数据则应当按持久化规则保存。
26.7 实例运行异常与恢复
智能实例在运行过程中,可能出现结构加载失败、初始化不完整、属性数据异常、方法处理器不存在、参数验证失败、程序执行超时、设备接口不可用、数据库保存失败和运行资源不足等异常。
运行引擎不能将所有异常简单处理为程序终止,而应当依据异常发生阶段、异常类型和实例当前状态,确定是否可以重试、恢复、暂停或进入人工处理。
实例运行异常可以按照发生阶段组织为:
其中,\(E_l\) 表示加载异常,\(E_i\) 表示初始化异常,\(E_p\) 表示属性处理异常,\(E_m\) 表示方法执行异常,\(E_s\) 表示状态转换异常,\(E_d\) 表示数据持久化异常,\(E_x\) 表示资源和运行环境异常。
不同异常需要采用不同处理方法。例如,结构定义不存在时不能通过反复执行方法解决;方法参数不合法时应当拒绝执行并返回参数错误;设备通信中断时应当进入通信异常处理流程;数据库保存失败时则需要保证运行结果不会在没有记录的情况下被误认为已经持久化。
异常管理程序可以组织为:
WSaiOS/
└── Runtime/
└── Exception/
├── RuntimeExceptionHandler.php
│ 功能:统一接收实例运行异常,识别异常类型并组织处理流程。
├── RuntimeErrorClassifier.php
│ 功能:依据异常发生阶段、错误标识和运行条件确定异常类别。
├── RuntimeRecoveryManager.php
│ 功能:依据异常类型和恢复规则执行重试、重新加载、暂停或恢复操作。
├── RuntimeCheckpointManager.php
│ 功能:保存允许恢复的实例运行检查点和任务执行进度。
└── RuntimeErrorRepository.php
功能:保存异常记录、恢复过程、处理结果及关联实例标识。
异常处理流程可以组织为:
恢复过程必须考虑实例当前状态和已经完成的操作。对于纯计算方法,如果执行过程没有产生外部副作用,可以在检查参数和运行上下文后重新执行;对于已经向外部设备发送控制指令的方法,则不能简单地重复发送,因为第一次指令可能已经执行,只是返回反馈没有成功到达。
因此,方法执行需要保留调用标识、执行阶段、处理器版本和执行结果。对于可能产生重复操作的任务,应当通过幂等标识、执行记录和设备反馈判断是否可以重试。
运行检查点可以记录实例当前运行阶段、任务标识、方法调用标识、已完成步骤、上下文版本和最近一次成功保存的状态。恢复时,运行引擎应当先读取检查点,检查对应结构版本、方法版本和外部环境是否仍然有效,再决定从哪个步骤继续执行。
检查点数据可以组织为:
{
"checkpoint_id": "checkpoint_001",
"instance_id": "motor_instance_001",
"structure_version": "1.0",
"runtime_status": "PAUSED",
"task_id": "task_001",
"method_call_id": "call_001",
"completed_steps": [
"parameter_validation",
"command_dispatch"
],
"pending_steps": [
"device_feedback_confirmation"
],
"last_saved_at": "2026-11-16 15:00:00"
}
该记录表示设备控制指令已经发送,但尚未完成反馈确认。恢复时不能直接重新发送启动指令,而应先查询设备当前状态或读取可用反馈,确认第一次操作是否已经生效,再决定继续执行还是重新执行。
运行异常记录应当与实例正常运行数据分开管理。异常记录用于追踪错误发生的时间、实例标识、方法调用、运行上下文版本、异常原因和恢复结果,不应直接覆盖实例原有属性和状态历史。
建议建立实例运行异常记录表:
CREATE TABLE ws_instance_runtime_error (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
error_id VARCHAR(64) NOT NULL,
instance_id VARCHAR(64) NOT NULL,
task_id VARCHAR(64) DEFAULT NULL,
method_call_id VARCHAR(64) DEFAULT NULL,
error_type VARCHAR(32) NOT NULL,
error_code VARCHAR(64) DEFAULT NULL,
error_message TEXT,
runtime_version VARCHAR(32) DEFAULT NULL,
recovery_status VARCHAR(32) NOT NULL,
created_at DATETIME NOT NULL,
KEY idx_instance_error (
instance_id,
created_at
)
);
实际工程中,异常记录还需要与运行检查点、方法调用记录、状态历史和实例版本建立关联,保证异常能够追溯到具体的程序执行过程。
实例恢复并不意味着无条件回到异常发生前的所有数据状态。已经完成并确认的外部操作不能因为程序恢复就被撤销;尚未确认的外部操作需要重新检查;属性和状态数据需要依据实际反馈决定是否更新。对于无法自动确认的异常,应当保持暂停或待处理状态,而不是为了恢复运行而强行将实例标记为正常。
本章建立的智能对象实例运行机制,形成了从实例加载、初始化、上下文建立、属性读取与修改、方法调用、状态变化,到多实例资源管理和异常恢复的完整运行过程。
其工程运行关系可以概括为:
其中,各部分分别承担实例加载、初始化、运行上下文建立、属性管理、方法执行、状态管理、资源管理和异常恢复职责。它们由统一运行引擎组织调用,但保持各自的数据管理和程序职责边界。
智能实例的运行由实例自身的结构、知识、能力、方法和状态条件决定。中央控制可以管理多个实例、分配任务和组织协同,但不应替代实例自身的运行逻辑。对于非通信运行环境,实例必须具备必要的本地运行条件、状态管理和安全约束;通信恢复后,再按照数据版本和同步规则与中央系统交换运行记录。
至此,WSaiOS 智能实例已经从前面的结构构建与实例化阶段进入实际运行阶段。下一章将进一步研究智能对象实例与 Smarty 模板之间的数据映射,明确运行对象数据如何组织为前台可读取的数据结构,以及如何在不改变智能结构和运行逻辑的前提下完成动态呈现。






