diff --git a/docs/develop/总体设计文档.md b/docs/develop/总体设计文档.md index 25f5644..5051835 100644 --- a/docs/develop/总体设计文档.md +++ b/docs/develop/总体设计文档.md @@ -1,6 +1,6 @@ 计划实现的bonus: - 缓存 -- 并发 +- 并行 - GUI前端和完整部署方案 有时间打算实现的bonus(按优先级次序排序): @@ -16,19 +16,25 @@ ## 后端 后端只有一个可执行文件,书店实例通过配置文件夹来决定(默认为当前目录下`.bookstore`文件夹,亦可通过命令行参数指定)。当书店系统在运行时,有且仅有一个后端进程,分为interactive模式(使用后端自带的交互,单会话模式)和server模式(通过WebUI交互)。 ### 数据库模块 -维护相关数据,支持并发(API阻塞但可同时运行)。 +维护相关数据,支持并行(API阻塞但可同时运行)。 #### 数据库设计方案 ### 引擎模块 -具体执行业务,支持并发(API阻塞但可同时运行)。 +具体执行业务,支持并行(API阻塞但可同时运行)。 + ### 通信模块 -负责对外提供文本模式的交互,从流`request`读取文本格式的命令,并把内部数据格式的响应翻译成文本格式,向引擎模块发送请求(调用引擎模块对外提供的API),并把响应返回到流`response`。支持并发:输入子模块从`request`读取指令,依次调用翻译子模块;翻译子模块向引擎模块API发送请求,得到响应后把响应数据传给输出子模块的调用接口(阻塞但可同时运行,处理部分同时运行,上锁后直接输出到`response`,输出本身不同时进行)。注意,输入输出仅保证单个请求/响应是完整的,多个请求/响应之间是完全“混杂”的,通过session token、operation token区分,通过outhentication key鉴权。`request`流和`response`流始终由信模块控制。注意,通讯模块不负责会话管理。 +负责对外提供文本模式的交互,从流`request`读取文本格式的命令,并把内部数据格式的响应翻译成文本格式,向引擎模块发送请求(调用引擎模块对外提供的API),并把响应返回到流`response`。支持并行: +- 输入子模块从`request`读取请求,启动一个线程调用翻译子模块。同一个会话的请求不可并行,把`std::thread`move进相应的`std::unordered_map`,同一会话下次请求发出前,必须join完。 +- 翻译子模块(入口函数本身阻塞)向引擎模块API发送请求,得到响应后把响应数据传给输出子模块的调用接口(阻塞但可并行,处理部分同时运行,上锁后直接输出到`response`,输出本身不同时进行)。 + +注意,输入输出仅保证单个请求/响应是完整的,多个请求/响应之间是完全“混杂”的,通过session token、operation token区分,通过outhentication key鉴权。`request`流和`response`流始终由信模块控制。注意,通讯模块不负责会话管理。 + ### 内置交互模块 当处于server模式下,直接把`std::cin`和`std::cout`绑给通信模块;处于interactive模式下时,提供会话管理,然后再调用通信模块。 标准输入输出始终由内置交互模块控制。 ## 前端 -~~不清楚有没有时间写~~。WebUI,采用`Node.JS`+`Socket.IO`,~~不打算弄得很好看,不打算支持响应式设计~~,支持图形化操作面板和“云命令行”。和interactive模式一样,单个会话的操作不支持并发。对于通讯中断、偶发的服务器未响应,只保证不会彻底崩掉,不保证出问题的业务能恢复。 +~~不清楚有没有时间写~~。WebUI,采用`Node.JS`+`Socket.IO`,~~不打算弄得很好看,不打算支持响应式设计~~,支持图形化操作面板和“云命令行”。和interactive模式一样,单个会话的操作不支持并行。对于通讯中断、偶发的服务器未响应,只保证不会彻底崩掉,不保证出问题的业务能恢复。 ### 服务端 提供会话管理 ### 客户端