zimoyin
177c3ae9b2
- 将 ProcessContext 中的 builder() 重命名为 createModifyBuilder() 并添加调用栈日志 - ProcessContextBuilder 中所有 with* 方法统一改为 set* 命名风格 - Flow 各节点及流程处理器中调用 builder() 替换为 createModifyBuilder() - 虚拟测试环境相关 ContextBuilder 中方法同步改名保持一致 - 优化流程节点中上下文修改代码调用，提升代码规范性 - 添加Config中加载自定义流程配置的占位注释及代码 - 无功能改动，纯代码风格及命名规范调整
142 lines
3.9 KiB
PHP
142 lines
3.9 KiB
PHP
<?php
|
||
|
||
namespace app\flow;
|
||
|
||
use app\config\Config;
|
||
use app\flow\config\ProcessConfig;
|
||
use app\flow\context\ProcessContext;
|
||
use app\net\PacketContext;
|
||
use app\utils\Logger;
|
||
|
||
/**
|
||
* FlowMain Flow入口类（单例）
|
||
*
|
||
* 职责：
|
||
* 1. 作为TCP服务器的入口点，接收刷卡事件
|
||
* 2. 管理流程处理器的生命周期（单例）
|
||
* 3. 从全局配置加载自定义流程配置
|
||
* 4. 提供配置热更新能力
|
||
*
|
||
* 与 FlowProcessor 的关系：
|
||
* - FlowMain 是入口和调度器（有状态单例）
|
||
* - FlowProcessor 是业务处理器（无状态，可被复用）
|
||
*
|
||
* @see FlowProcessor 流程处理器，处理具体业务逻辑
|
||
*/
|
||
class FlowMain
|
||
{
|
||
private FlowProcessor $flowProcessor;
|
||
|
||
/**
|
||
* 获取FlowMain实例（单例模式）
|
||
*/
|
||
private static ?FlowMain $instance = null;
|
||
|
||
|
||
public static function getInstance(): FlowMain
|
||
{
|
||
if (self::$instance === null) {
|
||
self::$instance = new self();
|
||
}
|
||
return self::$instance;
|
||
}
|
||
|
||
/**
|
||
* 私有构造函数，防止外部实例化
|
||
*/
|
||
private function __construct()
|
||
{
|
||
$this->flowProcessor = $this->createFlowProcessor();
|
||
|
||
}
|
||
|
||
/**
|
||
* 创建流程处理器
|
||
*
|
||
* 根据配置创建对应的 FlowProcessor
|
||
*/
|
||
private function createFlowProcessor(): FlowProcessor
|
||
{
|
||
$useCustomProcess = Config::getInstance()->flowUseCustomProcess;
|
||
$processConfigKey = Config::getInstance()->flowProcessConfigKey;
|
||
|
||
// 流程配置 通过流程配置可以实现，加载/卸载流程节点，添加/修改语音输出
|
||
$processConfig = null;
|
||
if ($useCustomProcess && !empty($processConfigKey)) {
|
||
// 从全局配置加载自定义流程
|
||
$customProcess = Config::getInstance()->customProcess;
|
||
$processConfigArray = $customProcess[$processConfigKey] ?? null;
|
||
|
||
if ($processConfigArray !== null) {
|
||
Logger::info("使用自定义流程: {}", [$processConfigKey]);
|
||
$processConfig = ProcessConfig::fromArray($processConfigArray);
|
||
return FlowProcessor::create($processConfig);
|
||
}
|
||
}
|
||
|
||
Logger::info("FlowMain 使用默认标准流程");
|
||
Logger::info("使用数据库: {}",[ Config::getInstance()->database->database]);
|
||
$processConfig = ProcessConfig::createStandard();
|
||
// 使用默认标准流程
|
||
return FlowProcessor::create($processConfig);
|
||
}
|
||
|
||
/**
|
||
* Flow主入口方法
|
||
*
|
||
* @param PacketContext $packetContext 数据包上下文
|
||
* @return ProcessContext
|
||
*/
|
||
public function main(PacketContext $packetContext): ProcessContext
|
||
{
|
||
// 调用流程处理器处理数据包并返回处理完成后的上下文
|
||
// process 参数：数据包上下文
|
||
// process 参数: 是否执行结果处理器，默认是执行
|
||
// 返回值: 处理完成后的数据包上下文
|
||
$packetContext = $this->flowProcessor->process($packetContext);
|
||
return $packetContext;
|
||
}
|
||
|
||
/**
|
||
* 获取流程处理器实例
|
||
*
|
||
* @return FlowProcessor
|
||
*/
|
||
public function getFlowProcessor(): FlowProcessor
|
||
{
|
||
return $this->flowProcessor;
|
||
}
|
||
|
||
/**
|
||
* 重新加载配置（配置热更新）
|
||
*
|
||
* @return void
|
||
*/
|
||
public function reloadConfig(): void
|
||
{
|
||
$this->flowProcessor = $this->createFlowProcessor();
|
||
}
|
||
|
||
/**
|
||
* 切换流程配置
|
||
*
|
||
* @param string $configKey 配置键名（如 'standard', 'no_morning_wash'）
|
||
* @return void
|
||
*/
|
||
public function switchConfig(string $configKey): void
|
||
{
|
||
self::$processConfigKey = $configKey;
|
||
$this->reloadConfig();
|
||
}
|
||
|
||
/**
|
||
* 重置单例（主要用于测试）
|
||
*
|
||
* @return void
|
||
*/
|
||
public static function resetInstance(): void
|
||
{
|
||
self::$instance = null;
|
||
}
|
||
}
|