第三章 框架总体架构
WangStruct Framework 的总体架构,是整个框架工程设计和程序开发的基础。框架后续的目录结构、核心类、基础组件、智能运行模块、扩展接口以及应用程序,都需要以总体架构为依据进行组织。
本章在前两章确定的框架定位和设计原则基础上,建立 WangStruct Framework 的整体技术架构,明确各组成层次的职责、模块之间的依赖关系、程序调用方式、数据流向和运行过程。
总体架构设计遵循三个基本要求:第一,框架核心保持精简和稳定;第二,各功能模块具有明确的职责边界和接口;第三,智能功能和应用功能能够在不改变核心运行机制的情况下持续扩展。
WangStruct Framework 采用分层组织与组件化结合的架构方式。分层用于明确系统职责和依赖方向,组件化用于组织具体功能,扩展机制用于支持第三方开发和不同技术实现。
3.1 总体架构设计思想
传统软件框架通常按照程序运行职责划分不同层次,例如核心运行层、数据访问层、业务逻辑层和应用展示层。
WangStruct Framework 在保留这些成熟软件工程思想的基础上,进一步考虑动态结构、知识管理、能力管理和智能运行等功能的工程组织需要。
因此,框架不能简单地将所有智能功能放入一个独立的业务模块,也不能将所有功能都直接放入核心层。
框架需要区分基础运行机制、通用服务、可复用功能组件、智能运行机制、外部扩展和具体应用。
按照这一要求,WangStruct Framework 的总体架构划分为六个主要层次:
-
核心层(Core Layer)
-
基础服务层(Foundation Service Layer)
-
功能组件层(Component Layer)
-
智能运行层(Intelligent Runtime Layer)
-
扩展层(Extension Layer)
-
应用层(Application Layer)
六个层次具有不同的工程职责,但不是六套彼此独立的程序。它们通过统一的接口、服务调用和数据交换机制共同构成一个完整的框架运行环境。
3.1.1 六层架构的基本关系
WangStruct Framework 总体架构
应用层 Application Layer
Web 应用 · 智能服务 · 智能个体 · 智能机器 · 第三方应用
应用接口 · 服务调用 · 运行结果
智能运行层 Intelligent Runtime Layer
需求组织 · 认知处理 · 决策 · 方法 · 行为 · 执行 · 反馈
结构、知识、能力及运行服务接口
功能组件层 Component Layer
结构管理 · 对象管理 · 知识管理 · 能力管理 · 任务管理 · 行为管理
公共服务接口 · 数据访问 · 事件与缓存
基础服务层 Foundation Service Layer
配置 · 自动加载 · 数据库 · 文件 · 缓存 · 日志 · 网络 · 安全
基础运行接口 · 组件注册 · 生命周期管理
核心层 Core Layer
启动 · 容器 · 注册表 · 调度 · 接口契约 · 生命周期
扩展层 Extension Layer(横向扩展体系)
第三方组件 · 外部能力 · 语言适配器 · 数据源适配器 · 通信适配器
通过注册、接口契约和适配机制接入相应层次,不要求所有扩展都处于同一调用位置。
上图表达的是框架的逻辑分层关系。扩展层采用横向扩展方式,能够根据扩展类型接入基础服务层、功能组件层、智能运行层或应用层,而不是一个只能由上层单向调用的独立业务层。
3.1.2 分层与组件化相结合
分层架构主要解决不同程序职责如何划分的问题,组件化主要解决具体功能如何独立组织的问题。
例如,知识管理属于功能组件层,但其运行可能需要使用基础服务层提供的数据存储和日志服务。
智能运行层中的需求处理模块,可以调用功能组件层的知识管理、结构管理和能力管理组件。
应用层可以调用智能运行层提供的运行接口,也可以直接使用基础服务层和功能组件层公开的通用接口。
因此,六层架构并不意味着所有程序都必须按照固定顺序逐层执行。
框架需要遵守的是明确的依赖规则和接口规范,而不是机械地要求所有调用都必须经过每一个层次。
3.2 核心层设计
核心层是 WangStruct Framework 的运行基础,负责框架启动、核心对象管理、组件注册、服务组织和生命周期控制。
核心层不直接承担具体行业业务,也不直接包含知识内容、智能个体行为或设备控制逻辑。
它主要负责让其他层次能够按照统一规范组织和运行。
3.2.1 核心层功能组成
核心层主要包含以下功能:
框架启动管理
负责读取启动配置,初始化运行环境,创建必要的核心对象,并按照既定顺序启动框架。
核心容器管理
负责管理框架中的核心服务对象和组件对象,提供统一的对象注册、获取和调用入口。
组件注册管理
负责记录已经注册的组件,管理组件名称、接口实现、依赖信息和加载状态。
接口契约管理
负责明确核心服务和组件之间的调用规范,使不同模块能够通过公共接口进行协作。
生命周期管理
负责控制核心对象、组件和服务的初始化、启动、运行和关闭过程。
基础运行调度
负责根据框架运行机制组织必要的服务调用和组件初始化。具体业务任务的组织和执行由相应功能模块承担。
3.2.2 核心层的主要程序对象
核心层可以围绕以下程序对象进行设计:
| 程序对象 | 主要职责 |
|---|---|
| Framework | 框架主入口与运行控制 |
| Application | 应用运行环境管理 |
| Container | 核心服务对象管理 |
| ComponentRegistry | 组件注册与查询 |
| ServiceRegistry | 服务注册与获取 |
| LifecycleManager | 生命周期管理 |
| InterfaceContract | 公共接口契约管理 |
这些名称是总体架构阶段确定的设计对象,不代表相关 PHP 类已经全部实现。具体类名、命名空间、方法签名和依赖关系,需要在第五章核心类与接口规范中统一确定。
3.2.3 核心层的调用原则
核心层应当保持最小依赖。
它可以管理其他模块的注册和生命周期,但不应当直接依赖某个具体知识管理组件、设备控制组件或行业业务模块。
例如,核心层只需要知道某个组件是否符合规定的组件接口,而不需要了解这个组件内部如何处理知识数据。
这样,即使开发者替换某个组件的实现,也不需要修改框架核心。
核心层与其他层次之间的关系应当以公共接口为基础。
3.3 基础服务层设计
基础服务层为框架和应用提供通用的软件工程服务。
它与核心层的区别在于:核心层负责组织和管理框架运行,基础服务层负责提供运行过程中需要使用的通用技术能力。
这些服务可以被多个功能组件和应用程序重复使用。
3.3.1 基础服务层功能组成
基础服务层主要包括以下服务模块。
配置管理服务
负责读取、解析、合并和管理框架配置及应用配置。
自动加载服务
负责按照约定的类加载规则查找和加载程序文件。
数据库服务
负责数据库连接、查询、事务、数据写入和数据读取。
文件管理服务
负责文件读取、写入、目录管理和文件访问控制。
缓存服务
负责提供统一缓存接口,支持不同缓存实现。
日志服务
负责记录系统运行信息、操作记录、异常信息和必要的调试信息。
网络通信服务
负责提供 HTTP 请求、接口调用和其他基础通信能力。
安全服务
负责提供身份验证、权限检查、访问控制和必要的安全机制。
事件与任务基础服务
负责提供通用事件分发和任务调度能力,为上层组件提供基础运行支持。
具体功能是否作为框架内置服务,还是通过可选组件接入,应当根据实际工程需要确定。
3.3.2 基础服务层的组织方式
基础服务层需要建立统一的服务接口,并允许不同技术实现。
例如,数据库服务可以提供统一的数据访问接口,但实际数据库驱动可以分别使用 MySQL、PostgreSQL 或其他数据库技术。
缓存服务可以定义统一的读写和删除接口,具体实现可以使用文件缓存、Redis 或其他适合的存储方式。
基础服务层不应当要求所有模块直接调用某个特定产品的内部方法。
其基本关系为:
当具体技术发生变化时,只要适配实现仍然满足公共接口约定,上层模块就不必随之修改。
3.3.3 基础服务层的依赖边界
基础服务层可以使用编程语言运行环境、数据库驱动、文件系统和网络通信等底层资源。
但它不应当依赖上层具体业务模块。
例如,数据库服务不应当依赖知识管理组件;文件服务不应当依赖智能个体管理模块;日志服务不应当依赖某一种应用程序。
基础服务层应当保持通用性,使其能够同时支持普通软件应用和开放式智能系统。
3.4 功能组件层设计
功能组件层是 WangStruct Framework 的主要功能组织层。
核心层和基础服务层提供框架运行条件,而功能组件层负责组织系统中具有明确业务或结构职责的功能模块。
这一层既包括传统软件框架中常见的功能组件,也包括开放式智能系统需要使用的动态结构、对象、知识和能力管理组件。
3.4.1 功能组件层的主要组成
功能组件层主要包含以下模块。
| 组件 | 主要功能 |
|---|---|
| 请求管理组件 | 请求数据处理和参数管理 |
| 路由管理组件 | 请求地址匹配和分发 |
| 控制器组件 | 应用请求处理与服务组织 |
| 模型组件 | 应用数据模型管理 |
| 视图组件 | 页面数据组织与展示 |
| 结构管理组件 | 动态结构定义与注册 |
| 对象管理组件 | 对象创建、实例化与生命周期管理 |
| 关系管理组件 | 对象关系定义与维护 |
| 语义管理组件 | 语义单元和语义关联管理 |
| 知识管理组件 | 知识元素、关系和状态管理 |
| 能力管理组件 | 能力定义、注册、匹配与调用 |
| 任务管理组件 | 任务创建、组织和状态管理 |
| 行为管理组件 | 行为规则与行为过程管理 |
这里需要区分组件的性质。
请求、路由、控制器、模型和视图属于通用软件工程组件;动态结构、语义、知识、能力和行为管理则是面向开放式智能系统的扩展功能组件。
两类组件可以在同一个功能组件层中协同运行,但不应当因此混淆各自的职责。
3.4.2 动态结构管理组件
动态结构管理组件负责结构定义、结构元素注册、属性管理和结构变更等操作。
例如,开发者可以定义一个设备结构:
$structure = array(
'name' => 'Device',
'properties' => array(
'device_id' => 'string',
'status' => 'string',
'temperature' => 'number'
)
);
结构管理组件负责接收结构定义,按照框架规范进行检查、注册和管理。
对象管理组件则可以根据已经注册的结构创建具体对象实例。
二者职责不同:结构管理负责定义对象的结构形式,对象管理负责创建和管理具体实例。
3.4.3 对象管理组件
对象管理组件负责对象实例的创建、属性赋值、查询、关系关联和生命周期管理。
例如:
$device = $objectManager->create('Device');
$device->set('device_id', 'D1001');
$device->set('status', 'active');
$device->set('temperature', 26.5);
这段代码表示一种可能的调用方式。
实际实现时,需要明确动态对象的属性校验、实例标识、数据持久化和方法调用规则。
动态对象不能只被理解为 PHP 普通对象。框架需要通过自身的对象管理机制,支持结构定义与实例数据之间的对应关系。
3.4.4 知识管理组件
知识管理组件负责知识元素的定义、保存、查询、关联和更新。
它可以通过结构管理组件建立知识数据的组织形式,通过对象管理组件关联具体对象,并通过基础服务层完成持久化。
知识管理组件不负责直接完成所有认知和决策过程,而是为上层智能运行机制提供知识组织和访问能力。
3.4.5 能力管理组件
能力管理组件负责能力的定义、注册、查询、匹配、组合和调用。
能力可以由不同开发者开发,也可以通过不同语言实现。
对于本地能力,框架可以通过程序调用接口执行;对于外部能力,则需要通过明确的通信协议调用相应服务。
能力管理组件负责统一管理能力的描述和调用关系,但具体能力的内部实现由相应的能力程序负责。
3.4.6 功能组件之间的关系
功能组件不是相互孤立的。
例如:
-
对象管理需要使用结构管理提供的结构定义;
-
知识管理需要使用对象管理和数据存储服务;
-
能力管理需要使用组件注册和任务管理机制;
-
行为管理可以调用能力管理提供的能力接口;
-
任务管理可以组织多个组件完成一个任务。
但这些调用必须建立在明确的接口基础上。
功能组件之间不能因为共享某些数据,就直接访问彼此的内部实现。
3.5 智能运行层设计
智能运行层是 WangStruct Framework 面向开放式智能系统开发的重要组成部分。
它负责将需求、知识、结构、能力和执行过程组织为相互关联的运行机制。
功能组件层主要负责提供具体的管理功能,智能运行层则负责按照任务需要组织这些功能,使系统能够形成完整的运行过程。
例如,知识管理组件负责管理知识,能力管理组件负责管理能力,任务管理组件负责管理任务;智能运行层则可以根据实际需求组织这些组件完成相应的处理过程。
3.5.1 智能运行层的主要组成
智能运行层主要包括:
-
需求处理模块;
-
需求分析与任务组织模块;
-
认知与理解模块;
-
决策管理模块;
-
方法管理模块;
-
行为管理模块;
-
执行管理模块;
-
反馈管理模块;
-
学习与演化模块。
这些模块之间具有逻辑关联,但不意味着它们必须全部实现为互相独立的程序文件。
实际开发时,应根据功能复杂度、调用边界和维护需要决定模块划分。
3.5.2 需求处理与任务组织
需求处理模块负责接收应用产生的需求信息,并将其转换为系统能够组织和处理的任务数据。
需求可能来自用户输入、外部系统、设备状态变化或其他应用事件。
任务组织模块根据需求内容建立任务对象,并确定完成任务所需要的结构、知识、能力和执行资源。
例如,用户提出查询设备运行状态的需求,系统需要识别目标设备,获取相关状态数据,并组织相应的读取能力完成任务。
这里的需求处理不应当被限定为某一种自然语言处理算法。框架提供的是需求数据组织、任务管理和后续处理接口,具体理解机制可以根据实际应用进行开发和扩展。
3.5.3 认知与理解模块
认知与理解模块负责对任务相关的信息进行组织和处理,建立需求、知识、对象和能力之间的关联。
它可以调用语义管理、知识管理和结构管理组件,获取与当前需求相关的信息,并形成后续决策所需要的处理结果。
认知与理解不是简单地从数据库中查找一个字段,也不是将所有用户输入直接映射到预先设定的固定字段。
实际应用需要根据具体需求,组织相关信息、识别对象关系并形成可供后续处理的结果。
3.5.4 决策与方法管理
决策管理模块根据当前需求、可用知识、系统状态和能力条件,确定下一步处理方式。
方法管理模块负责组织具体的处理方法,并按照接口规范调用相应能力。
例如,设备异常处理任务可能需要先读取设备状态,再判断是否满足某项控制条件,最后决定是否执行相应操作。
决策与方法不能简单合并为一个固定业务函数。决策负责确定处理方向,方法负责提供具体的处理过程。
3.5.5 行为与执行管理
行为管理模块负责组织系统的行为规则和行为过程。
执行管理模块负责调用相应方法和能力,使任务从逻辑处理进入实际执行阶段。
执行对象可以是软件程序、外部服务、智能个体或设备控制接口。
对于涉及实际设备的执行操作,必须经过权限检查、参数校验和设备安全约束,不能将普通程序调用直接视为安全的物理控制。
3.5.6 反馈与学习演化
反馈管理模块负责收集任务执行结果、对象状态变化和运行异常等信息。
学习与演化模块则可以根据应用定义的规则,对知识、结构、能力或行为进行必要的更新。
需要特别说明,反馈并不意味着系统自动修改所有知识和结构,学习也不意味着任何运行结果都可以直接变成有效知识。
框架应当提供相应的记录、验证、确认和更新机制,具体学习与演化规则由实际智能系统定义。
3.5.7 智能运行逻辑
智能运行层可以按照以下逻辑组织运行:
这条逻辑用于说明智能运行模块之间的组织关系,并不是要求所有任务都严格按照固定顺序执行。
具体任务可以根据实际需求跳过不需要的处理环节,也可以在执行过程中返回前面的环节重新组织知识、结构和能力。
3.6 扩展层设计
扩展层是 WangStruct Framework 面向第三方开发者和不同技术环境建立的开放接入体系。
它不应当被设计为一个只能放置在框架最上层的功能模块。
扩展层更准确的定位,是一套横向扩展机制。第三方开发者可以根据扩展功能的性质,将组件接入框架相应层次。
3.6.1 扩展层的主要类型
扩展层主要支持以下几类扩展。
基础服务扩展
例如,新的数据库驱动、缓存服务、文件存储和网络通信适配器。
功能组件扩展
例如,新的结构管理方式、知识管理组件、能力管理组件和行业功能模块。
智能运行扩展
例如,新的需求处理机制、认知处理模块、决策方法和行为管理机制。
应用扩展
例如,第三方开发的智能服务应用、设备管理应用和专业领域应用。
语言与通信适配扩展
例如,PHP 与 Python 程序之间的 HTTP 接口适配、不同语言的消息通信以及外部设备通信接口。
3.6.2 扩展组件的接入方式
扩展组件应当按照框架规定的注册规范进行接入。
一个完整的扩展组件至少需要明确:
-
组件名称与唯一标识;
-
组件版本;
-
组件功能说明;
-
所实现的接口;
-
所依赖的其他组件;
-
所需运行环境;
-
初始化和关闭方式;
-
配置参数;
-
对外提供的服务。
框架通过组件注册机制识别扩展,并根据依赖关系和运行条件决定是否加载。
3.6.3 第三方扩展与核心隔离
第三方扩展不能直接修改框架核心程序来实现自己的功能。
如果第三方开发者需要增加某项能力,应当优先通过公共接口、组件注册和适配器机制接入。
这样可以避免第三方程序与核心程序形成紧密耦合,也能降低框架升级时对第三方组件造成的影响。
对于需要访问底层资源的扩展,还应当通过权限和安全机制控制其运行范围。
3.7 应用层设计
应用层是开发者最终构建实际软件产品的层次。
框架本身提供的是开发基础和运行机制,具体应用由开发者根据业务需求进行设计和实现。
应用层不应当将框架的全部功能都直接暴露给最终用户,而应当按照具体项目的需要,组织相应的页面、接口、业务逻辑和智能功能。
3.7.1 应用层的主要组成
应用层主要包括:
-
应用程序入口;
-
应用配置;
-
控制器与业务服务;
-
页面与模板;
-
应用数据模型;
-
智能应用对象;
-
应用知识与能力;
-
外部系统接口;
-
应用运行规则。
不同应用可以选择不同的程序组织方式。
例如,Web 应用可以采用 MVC 或 MVP 方式组织请求、业务处理和页面展示;后台服务可以采用 API 方式提供接口;智能机器应用则可以通过设备适配器与底层控制程序协作。
3.7.2 不同应用类型的构建方式
WangStruct Framework 不限定应用层只能构建一种软件。
例如:
普通 Web 应用
可以使用框架的请求、路由、控制器、模型和视图组件,构建网站、后台管理系统和业务平台。
智能服务应用
可以使用需求管理、知识管理、能力管理和智能运行模块,构建面向用户需求的服务系统。
智能个体应用
可以通过对象实例化、知识赋予、能力配置和行为管理机制,构建具有不同属性和运行规则的智能个体。
智能机器应用
可以通过设备对象、环境对象、感知接口、控制能力和执行接口,构建面向实际设备的智能应用。
这些应用可以使用同一框架的基础工程规范,但其具体功能、结构和运行方式由应用开发者决定。
3.8 各层之间的程序调用关系
分层架构必须落实到实际程序调用关系,不能只停留在架构图上。
WangStruct Framework 的调用关系需要明确三个方面:调用者与被调用者的职责边界、公共接口的使用方式,以及模块之间的数据传递方式。
3.8.1 基本调用方向
在常规运行情况下,调用关系主要表现为:
核心层负责管理这些模块的注册、加载和运行环境。
但这一关系并不意味着所有调用只能沿着一个方向进行。
例如,应用层可以直接调用路由和数据库等通用服务;智能运行层可以直接调用能力管理组件;功能组件之间也可以通过公共接口相互协作。
因此,框架需要区分两种关系:
程序调用关系: 某个模块在运行过程中调用另一个模块的接口。
模块依赖关系: 某个模块在设计或运行上必须依赖另一个模块提供的能力。
这两种关系不完全相同。某个模块可能通过事件或消息间接调用其他模块,而不直接依赖其内部实现。
3.8.2 依赖关系规范
总体架构阶段,首先确定以下依赖约束:
| 模块 | 允许依赖的主要对象 | 不应形成的依赖 |
|---|---|---|
| 核心层 | 运行环境、核心接口 | 具体行业应用 |
| 基础服务层 | 核心接口、底层技术 | 智能应用业务 |
| 功能组件层 | 核心接口、基础服务、其他公开组件接口 | 具体应用内部实现 |
| 智能运行层 | 功能组件公开接口、基础服务接口 | 特定组件内部实现 |
| 扩展层 | 所扩展目标层的公开接口 | 修改核心内部实现 |
| 应用层 | 框架公开接口及应用自身模块 | 依赖未公开的内部实现 |
扩展层的依赖关系需要根据具体扩展类型确定。它并不是一个具有固定依赖方向的普通业务层。
3.8.3 接口调用示例
例如,应用层需要创建一个设备对象,可以通过对象管理服务完成:
$device = $objectManager->create('Device');
$device->set('device_id', 'D1001');
$device->set('status', 'active');
对象管理服务通过结构管理组件获得 Device 的结构定义,再通过数据服务保存对象数据。
其内部调用关系可以表示为:
应用程序
提出设备对象创建请求
对象管理组件
创建对象实例并管理属性
结构管理组件
读取 Device 结构定义并校验属性
数据访问服务
完成对象数据持久化
这里的调用关系用于说明模块协作方式。具体实现中,对象管理组件可能通过结构服务接口获取结构定义,数据访问则可以通过仓储接口完成,避免直接依赖数据库内部实现。
3.9 框架数据流向设计
数据流向是总体架构中另一个重要问题。
框架中的数据不仅包括用户提交的请求数据,还包括结构定义、对象属性、知识内容、能力描述、任务状态和执行结果。
不同类型的数据具有不同的产生来源、存储方式和使用范围。
因此,框架不能将所有数据统一理解为普通业务表记录,也不能将所有数据都直接放在内存对象中。
3.9.1 基础应用数据流
普通应用的数据流通常表现为:
例如,用户通过浏览器提交一个设备查询请求,框架首先接收请求,再根据路由规则找到对应控制器,控制器调用业务服务,业务服务通过数据访问组件获取数据,最后将结果返回给用户。
3.9.2 动态结构数据流
动态结构数据主要包括结构名称、元素定义、属性定义、类型信息和关系信息。
其基本流向为:
当结构发生变化时,需要根据结构版本和数据兼容规则处理已经创建的对象实例。
结构定义与对象实例数据应当分开管理,避免结构变化直接破坏历史数据。
3.9.3 知识数据流
知识数据可能来自用户输入、外部资料、系统运行结果和开发者定义。
其基本流向可以表示为:
知识进入系统后,还需要经过必要的校验和管理。
外部资料和运行结果不能未经判断就直接作为有效知识使用。系统需要根据实际应用建立来源记录、确认规则和更新机制。
3.9.4 能力数据流
能力数据主要包括能力定义、参数要求、调用接口、依赖关系和执行结果。
其基本流向为:
能力的描述信息和能力实际执行过程需要分开管理。
框架可以管理能力定义和调用关系,但具体能力程序可以在不同进程、不同服务器甚至不同编程语言环境中运行。
3.9.5 智能运行数据流
智能运行过程中,需求、知识、结构、能力和执行结果之间会形成动态数据关系。
例如:
用户提出一项需求后,系统建立需求记录,根据需求组织相关信息,关联相关对象和知识,查找可用能力,确定执行方法,调用相应程序,并将执行结果反馈到当前任务。
其数据流并非简单的单向流水线。
当执行结果不符合预期时,系统可能重新组织知识和能力,调整方法后再次执行。
因此,智能运行层需要支持任务状态保存、执行过程记录、结果反馈和必要的重新处理。
3.10 框架启动与运行过程
总体架构最终需要落实为真实的程序运行过程。
WangStruct Framework 的启动机制应当由核心层统一管理,其他层次按照依赖顺序完成初始化。
3.10.1 框架启动过程
框架启动可以按照以下基本步骤组织:
-
程序入口接收运行请求;
-
加载基础运行配置;
-
初始化核心容器;
-
注册核心服务;
-
加载基础服务;
-
读取组件注册信息;
-
检查组件依赖;
-
初始化必要功能组件;
-
注册智能运行模块;
-
初始化应用程序;
-
进入请求处理或任务运行状态。
这里的启动顺序是总体设计方案。实际实现时,需要进一步区分必须启动的组件和按需加载的组件,避免每次启动都加载全部功能。
3.10.2 框架启动流程图
框架启动过程中,如果某个非必要扩展组件加载失败,可以根据组件重要程度决定是否隔离该组件并继续启动;如果核心服务或必要依赖无法初始化,则应当停止相关运行过程并报告错误。
3.10.3 普通请求运行过程
以 Web 应用为例:
-
用户访问应用地址;
-
请求管理组件接收请求;
-
路由组件匹配请求地址;
-
控制器接收请求参数;
-
控制器调用业务服务;
-
业务服务调用相关功能组件;
-
功能组件使用基础服务完成数据处理;
-
处理结果返回控制器;
-
视图组件生成响应内容;
-
请求处理结束。
3.10.4 智能任务运行过程
以设备状态查询为例:
-
用户提交设备状态查询需求;
-
需求处理模块建立任务;
-
认知与理解模块组织需求相关信息;
-
结构管理和对象管理组件定位目标设备;
-
知识管理组件提供相关知识;
-
能力管理组件匹配设备状态读取能力;
-
决策与方法模块确定调用方式;
-
执行模块调用设备读取接口;
-
反馈模块记录读取结果;
-
应用层向用户返回处理结果。
这里的设备状态读取只是说明模块协作关系。实际设备控制还需要设备驱动、通信协议、权限检查和安全约束等工程实现,不能仅依赖框架内部的对象方法。
3.11 模块关系与架构约束规范
总体架构必须转化为后续程序开发能够遵循的规范。
因此,WangStruct Framework 需要建立模块关系约束,避免在实际开发过程中出现随意调用、重复实现和循环依赖等问题。
3.11.1 模块唯一职责
每个模块应当具有明确的功能范围。
如果两个模块承担相同职责,应当分析是否存在功能重复,并确定统一的责任归属。
例如,结构定义由结构管理组件负责,对象实例由对象管理组件负责,知识内容由知识管理组件负责。
不能让多个组件分别维护一套相互独立的对象结构定义。
3.11.2 公共接口优先
模块之间需要协作时,应当优先通过公开接口完成。
不能为了调用方便而直接访问其他模块的内部属性、数据库表或私有方法。
公共接口需要明确参数、返回值、异常和版本信息。
3.11.3 避免循环依赖
模块依赖关系应当保持清晰。
例如:
-
核心层管理组件,不依赖具体业务组件;
-
基础服务层提供通用服务,不依赖智能运行模块;
-
功能组件层使用基础服务,不反向修改基础服务内部实现;
-
智能运行层组织功能组件,不直接依赖具体组件的内部代码;
-
应用层组织应用功能,不修改框架核心程序。
如果两个模块确实需要相互协作,应当分析是否可以通过公共接口、事件机制或独立的协调服务解除直接循环依赖。
3.11.4 组件可独立测试
每个组件都应当具备独立测试条件。
组件测试至少需要验证:
-
初始化是否成功;
-
接口参数是否正确;
-
返回数据是否符合规范;
-
依赖组件是否正常工作;
-
异常是否能够正确处理;
-
组件关闭时是否释放必要资源。
3.11.5 组件替换不改变上层接口
同一功能类型的不同实现,应当遵守相同的公共接口。
当组件替换时,必须验证数据格式、执行行为和异常处理是否兼容。
不能只因为两个组件具有相同的方法名称,就认为它们完全可以替换。
3.11.6 核心与扩展保持隔离
第三方扩展必须通过规定的接口接入。
框架核心不能依赖某一个第三方扩展才能正常启动,第三方扩展也不能通过修改核心程序内部文件来实现正常运行。
3.12 总体架构的工程实施边界
本章确定的是 WangStruct Framework 的总体逻辑架构,并不意味着六个层次中的所有功能已经完成程序实现。
在工程开发中,需要进一步区分三个阶段。
第一阶段:架构与接口确定。
确定各层的职责边界、模块关系、核心类、公共接口和数据规范。
第二阶段:核心程序与基础组件实现。
建立项目入口、核心容器、自动加载、配置管理、数据访问和组件注册等基础程序。
第三阶段:智能功能与应用扩展实现。
逐步实现动态结构、对象管理、知识管理、能力管理、智能运行和第三方扩展功能。
这些阶段之间存在依赖关系,但不是完全孤立的开发阶段。部分组件可以在接口确定后并行开发,最终通过集成测试验证整体架构。
尤其需要注意,语言无关规范与具体语言实现必须分别确定。PHP 参考实现不能直接代替整个框架的跨语言规范;其他语言的开发者也不能仅凭采用相同的数据字段,就被认为已经实现了兼容。
3.13 本章小结
WangStruct Framework 采用核心层、基础服务层、功能组件层、智能运行层、扩展层和应用层相结合的总体架构。
核心层负责框架启动、容器管理、组件注册和生命周期控制;基础服务层提供配置、数据库、文件、缓存、日志和通信等通用服务;功能组件层组织动态结构、对象、知识、能力和任务等具体功能;智能运行层负责组织需求、理解、决策、方法、行为、执行、反馈和演化等运行过程;扩展层提供第三方组件、外部能力和不同语言实现的接入机制;应用层则负责构建具体的软件产品。
六层架构共同构成框架的工程组织基础,但不意味着所有程序必须严格按照固定顺序调用。框架真正需要统一的是模块职责、公共接口、依赖关系、数据交换和运行约束。
通过这一总体架构,WangStruct Framework 将传统软件工程基础与开放式智能系统的工程需求结合起来,为后续核心程序设计、组件开发和智能应用构建建立统一的技术依据。
下一章将进一步确定框架的实际项目目录结构,明确每个目录的用途、每个程序文件的职责,以及核心程序、基础组件、智能模块、扩展组件和应用程序之间的文件组织关系。
