From fd5606f4abf1f867e2f153051377cf40f34a8eea Mon Sep 17 00:00:00 2001 From: ZhuangYumin Date: Tue, 28 Nov 2023 08:23:02 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E6=88=90=E5=B9=B6=E5=8F=91?= =?UTF-8?q?=E7=9B=B8=E5=85=B3=E7=9A=84=E6=80=BB=E4=BD=93=E8=AE=BE=E8=AE=A1?= =?UTF-8?q?=EF=BC=8C=E5=87=86=E5=A4=87=E5=BC=80=E5=A7=8B=E7=A1=AE=E8=AE=A4?= =?UTF-8?q?=E7=BB=86=E8=8A=82=E5=90=88=E7=90=86=E6=80=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/develop/总体设计文档.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/develop/总体设计文档.md b/docs/develop/总体设计文档.md index 14ed706..c395545 100644 --- a/docs/develop/总体设计文档.md +++ b/docs/develop/总体设计文档.md @@ -26,14 +26,20 @@ ~~因此我不太打算碰文件系统~~ #### 数据库设计方案 +##### 数据结构 + +##### 文件访问与缓存 + +##### 并发安全 + ### 引擎模块 -具体执行业务，一次请求对应且只对应一次引擎模块API调用，支持并行（API阻塞但可同时运行）。 +具体执行业务，一次请求对应且只对应一次引擎模块API调用，支持并行（API阻塞但可同时运行）。当API入口函数被调用后，执行相关具体操作，然后返回响应。 ### 通信模块 负责对外提供文本模式的交互，从流`request`读取文本格式的命令，并把内部数据格式的响应翻译成文本格式，向引擎模块发送请求（调用引擎模块对外提供的API），并把响应返回到流`response`。支持并行： -- 输入子模块从`request`读取请求，启动一个线程调用翻译子模块。同一个会话的请求不可并行，把`std::thread`move进相应的`std::unordered_map`，同一会话下次请求发出前，必须join完。 -- 翻译子模块(入口函数本身阻塞)向引擎模块API发送请求，得到响应后把响应数据传给输出子模块的调用接口(阻塞但可并行，处理部分同时运行，上锁后直接输出到`response`，输出本身不同时进行)。 +- 输入子模块从`request`读取请求，打上时间戳，分独占式请求和可并行请求按时间戳顺序分批处理。处理一个请求时，启动一个线程调用翻译子模块。同一个会话的请求不可并行，把`std::thread`move进相应的该会话的线程句柄队列，下一个join前一个。 +- 翻译子模块(入口函数本身阻塞)join完同一个session的上一个请求后，向引擎模块API发送请求，得到响应后把响应数据传给输出子模块的调用接口(阻塞但可并行，处理部分同时运行，上锁后直接输出到`response`，输出本身不同时进行)。 注意，输入输出仅保证单个请求/响应是完整的，多个请求/响应之间是完全“混杂”的，通过session token、operation token区分，通过outhentication key鉴权。`request`流和`response`流始终由信模块控制。注意，通讯模块不负责会话管理。