架构

模块化设计

ThinkJS 基于 分组/控制器/操作 的设计原则,一个典型的 URL 如下:

http://hostname:port/分组/控制器/操作/参数名/参数值/参数名2/参数值 2?arg1=argv1&arg2=argv2

  • 分组 一个应用下有多个分组,一个分组都是很独立的模块。比如:前台模块、用户模块、管理员模块
  • 控制器 一个分组下有多个控制器,一个控制器是多个操作的集合。如:商品的增删改查
  • 操作 一个控制器有多个操作,每个操作都是最小的执行单元。如:添加一个商品

项目中有哪些分组,需要在如下的配置中指定:

// 支持的分组列表
'app_group_list': ['Home', 'Admin'], // 表示有 Home 和 Admin 2 个分组

默认是哪个分组,可以在下面的配置中指定:

// 默认分组
'default_group': 'Home', // 你可以将默认分组改成合适的,如:Blog

CBD 模式

ThinkJS 使用 CBD(核心 Core+ 行为 Behavior+ 驱动 Driver) 的架构模式,核心保留了最关键的部分,并在重要位置添加了 切面,其他功能都是以驱动的方式来完成。

核心 (Core)

ThinkJS 的核心部分包含通用函数库、系统默认配置、核心类库等组成,这些都是 ThinkJS 必不可少的部分。

lib/Common/common.js 通用函数库
lib/Common/extend.js js 原生对象的扩展
lib/Common/function.js 框架相关的函数库
lib/Conf/alias.js  系统类库别名,加载时使用
lib/Conf/config.js 系统默认配置
lib/Conf/debug.js debug 模式下的配置
lib/Conf/mode.js  不同模式下的配置
lib/Conf/tag.js  每个切面下的行为
lib/Lib/Core/App.js  应用核心库
lib/Lib/Core/Controller.js 控制器基类
lib/Lib/Core/Db.js  数据库基类
lib/Lib/Core/Dispatcher.js 路由分发类
lib/Lib/Core/Http.js 封装的 http 对象类
lib/Lib/Core/Model.js 模型基类
lib/Lib/Core/Think.js 框架类
lib/Lib/Core/View.js 视图类
lib/Lib/Util/Behavior.js 行为基类
lib/Lib/Util/Cache.js 缓存基类
lib/Lib/Util/Cookie.js cookie
lib/Lib/Util/Filter.js 数据过滤类
lib/Lib/Util/Session.js session 基类
lib/Lib/Util/Valid.js 验证类

行为 (Behavior)

行为是 ThinkJS 扩展机制中一项比较关键的扩展,行为可以独立调用,也可以整合到标签 (tag) 里一起调用,行为是执行过程中一个动作或事件。如:路由检测是个行为、静态缓存检测也是个行为。

标签 (tag) 是一组行为的集合,是在系统执行过程中切面处调用的。与 EventEmitter 不同,标签里的行为是按顺序执行的,当前的行为通过 Promise 机制控制后面的行为是否被执行。

系统标签位

当执行一个 http 请求时,会在对应的时机执行如下的标签位:

  • app_init 应用初始化
  • path_info 解析 path 路径
  • resource_check 静态资源请求检测
  • route_check 路由检测
  • app_begin 应用开始
  • action_init action 初始化
  • view_init 视图初始化
  • view_template 模版定位
  • view_parse 模版解析
  • view_filter 模版内容过滤
  • view_end 视图结束
  • action_end action 结束
  • app_end 应用结束

在每一个标签位置都可以配置多个行为,系统的标签位行为如下:

/**
 * 系统标签配置
 * 可以在 App/Conf/tag.js 里进行修改
 * @type {Object}
 */
module.exports = {
    // 应用初始化
    app_init: [],
    //pathinfo 解析
    path_info: [],
    // 静态资源请求检测
    resource_check: ['CheckResource'],
    // 路由检测
    route_check: ['CheckRoute'],
    // 应用开始
    app_begin: ['ReadHtmlCache'],
    //action 执行初始化
    action_init: [],
    // 模版解析初始化
    view_init: [],
    // 定位模版文件
    view_template: ["LocationTemplate"],
    // 模版解析
    view_parse: ["ParseTemplate"],
    // 模版内容过滤
    view_filter: [],
    // 模版解析结束
    view_end: ['WriteHtmlCache'],
    //action 结束
    action_end: [],
    // 应用结束
    app_end: []};

除了系统的标签位行为,开发人员也可以根据项目的需要自定义标签位行为。

自定义标签位行为文件在 App/Conf/tag.js

行为定义

行为定义有 2 种方式,一种是一个简单的 function,一种是较为复杂些的行为类。

可以通过下面直接 function 的方式创建一个简单的行为,文件为 App/Conf/tag.js

module.exports = {app_begin: [
    function(http){ // 会传递一个包装的 http 对象
        if (http.group !== 'Home') {
            return;
        };
        var userAgent = http.getHeader('user-agent').toLowerCase();
        var flag = ["iphone", "android"].some(function(item){
            return userAgent.indexOf(item) > -1;
        })
        if (flag) {
            http.group = "Mobile";
        }
    }]
}

该行为的作用是:如果当前的分组是 Home 并且是手机访问,那么将分组改为 Mobile。这样就可以对同一个 url,PC 和 Mobile 访问执行不同的逻辑,输出不同的内容。

也可以继承行为基类来实现:

module.exports = Behavior(function(){
    return {
        run: function(){
            var http = this.http; // 基类中的 init 方法会自动把传递进来的 http 对象放在当前对象上。
            if (http.group !== 'Home') {
                return;
            };
            var userAgent = http.getHeader('user-agent').toLowerCase();
            var flag = ["iphone", "android"].some(function(item){
                return userAgent.indexOf(item) > -1;
            })
            if (flag) {
                http.group = "Mobile";
            }
        }
    }
})

将内容保存在 App/Lib/Behavior/AgentBehavior.js 文件中,并在 App/Conf/tag.js 中配置如下的内容:

module.exports = {
    app_begin: ["Agent"]
}

使用哪种方式来创建行为可以根据行为里的逻辑复杂度来选择。

行为执行顺序

默认情况下,自定义的行为会和系统的行为一起执行,并且自定义行为是追加到系统行为之后的。

如果想更改行为执行的顺序,可以通过下面的方式:

  • app_begin: [true, 'Agent'] 将数组的第一个值设置为 true, 表示自定义行为替换系统默认的行为,那么系统的默认行为则不在执行。
  • app_begin: [false, 'Agent'] 将数组的第一个值设置为 false, 表示自定义行为放在系统的默认行为之前执行。
自定义标签位执行和行为执行

上面提到的标签位和行为会在 http 执行过程中自动被调用,同时标签和行为也可以手工调用:

// 执行 check_auto 标签位,
//http 为包装的 http 对象,在整个 http 执行过程中都可以获取到
//data 为传过去的数据, 如果行为里需要的是多个数据,那么这里应该传递个数组
tag("check_auth", http, data); 
// 执行 Agent 这个行为
B("Agent", http, data);

驱动 (Driver)

除了核心和行为外,ThinkJS 里的很多功能都是通过驱动来实现的,如:Cache, Session, Db 等。

驱动包括:

  • lib/Lib/Driver/Cache 缓存驱动
  • lib/Lib/Driver/Db 数据库驱动
  • lib/Lib/Driver/Session Session 驱动
  • lib/Lib/Driver/Socket Socket 驱动
  • lib/Lib/Driver/Template 模版引擎驱动

如果有些功能框架里还没实现,如:mssql 数据库,那么开发人员可以在项目里 App/Lib/Driver/Db/ 里实现。

自动加载

Node.js 里虽然提供了 require 来加载模块,但对于应用内的文件加载并没有给出快捷的加载方式。为此 ThinkJS 实现了一套快速加载机制,这些快速加载的文件包含:

  • 系统核心文件
  • 行为文件
  • 各种驱动文件

通过全局函数 thinkRequire 来调用。例如:

// 调用这些文件时会自动到对应的一些目录下查找
var db = thinkRequire("mssqlDb"); 
var model = thinkRequire("userModel");
var behavior = thinkRequire("AgentBehavior");

这些文件具体包含:xxxBehavior, xxxModel, xxxController, xxxCache, xxxDb, xxxTemplate, xxxSocket, xxxSession

如果是这些之外的文件通过 thinkRequire 加载,那么会调用系统 require 函数。

系统流程

系统的执行流程分为启动服务和响应用户请求 2 块:

启动服务

  • 通过 node index.js 启动
  • 调用系统入口文件 think.js
  • 常量定义,获取 ThinkJS 的版本号
  • 加载 lib/Lib/Core/Think.js 文件,调用 start 方法
  • 加载系统的函数库、系统默认配置
  • 捕获异常
  • 加载项目函数库、配置文件、自定义路由配置、行为配置、额外的配置文件
  • 合并 autoload 的查找路径列表,注册 autoload 机制
  • 记录当前 Node.js 的进程 id
  • 加载 lib/Lib/Core/App.js 文件,调用 run 方法
  • 识别是否使用 cluster,开启 http 服务

响应用户请求

  • 用户发生了 url 访问
  • 执行标签位 form_parse
  • 发送 X-Powered-By 响应头信息,值为 ThinkJS 的版本号
  • 执行标签位 app_init
  • 执行标签位 resource_check,判断当前请求是否是静态资源类请求。静态资源类请求执行标签位 resource_output
  • 执行标签位 path_info,获取修改后的 pathname
  • 执行标签位 route_check,进行路由检测,识别对应的 Group, Controller, Action
  • 执行标签位 app_begin,检测当前请求是否有静态化缓存
  • 执行标签位 action_init,实例化 Controller
  • 调用 __before 方法,如果存在的话
  • 调用对应的 action 方法
  • 调用 __after 方法,如果存在的话
  • 执行标签位 view_init,初始化模版引擎
  • 执行标签位 view_template, 查到模版文件的具体路径
  • 执行标签位 view_parse,解析模版内容
  • 执行标签位 view_filter,对解析后的内容进行过滤
  • 执行标签位 view_end,模版渲染结束
  • 执行标签位 app_end, 应用调用结束
如发现文档中的错误,请点击这里修改本文档,修改完成后请 pull request,我们会尽快合并、更新。