nocobase/docs/plugins/tutorials/server-lifecycle.md

title	order	toc
NocoBase 生命周期	2	menu

NocoBase 生命周期

每个 NocoBase 实例在被创建时都要经过一系列的初始化过程，在这个过程中某些节点会运行一些函数，这些节点就是生命周期的钩子，有了钩子的存在，代码不论按什么顺序书写，都会按照既定的顺序执行。NocoBase 的生命周期大概分为四个环节：

1. 初始化实例
2. 加载配置
3. 数据库操作
4. 每次请求中

初始化实例

• koa：nocobase 实例
• database：数据库实例
• resourcer：koa 的分支，负责 resource router
• pluginManager：插件管理器实例

现阶段的设计 sever 直接继承了 koa application，其他三个作为 server 实例的成员存在。

pluginManager 的初始化存在较大缺陷，在初始化时直接加载了配置，暂时无法处理数据库操作。

加载配置

• table hooks：表配置事件
• table options：表配置
• model hooks：model 事件

系统表配置从文件目录里导入，业务表配置从数据库里导入，部分开放的系统表从文件目录导入之后，又从数据库里更新，如用户表。

resourcer 配置是运行时初始化，在 koa middleware 中。hooks 分 table、model、plugin、resourcer 四类，暂时并不统一。

另外，还有个非常重要的细节，生命周期解决了大结构的执行顺序，但并未解决同一挂载点多钩子之间的执行顺序。

数据库操作

• initialize：初始化，app 启动或重启时都执行
• install：安装操作，只执行一次
• upgrade：更新操作，只执行一次
• uninstall：卸载操作，只执行一次

目前还不支持，这部分的钩子主要用于管理插件。

每次请求中

• koa middleware
• resourcer middleware
• resource middleware
• action middleware
• action handler

客户端请求时，都会执行。

虽然大部分框架都提供了中间件，但是中间件的执行顺序（优先级）依赖于编码顺序，这种方式非常不利于插件化管理。因此，在 Resourcer 设计思想里，将中间件做了分层，不同层级的 middlewares 不依赖于编码顺序，而是如下顺序：

1. 首先，koa 层：koa.use
2. 其次，resourcer 层：resourcer.use
3. 再次，resource 层（每个资源独立）：resourcer.registerActionMiddleware
4. 然后，action 层：resourcer.registerResourceMiddleware
5. 最后，执行 action handler

不过，每个层次的中间件执行顺序还依赖于编码顺序，如有需要再进行更细微的改进。