ThinkJS 1.2 中文文档

• 语言: 中文（简体）
• 格式: .pdf
• 来源: thinkjs.org

摘要

ThinkJS 是一个高效且简单易用的 Node.js MVC 框架，基于 ES6 Promise 开发，支持 Http、命令行、WebSocket 和 Restful 等多种调用方式。其架构采用 CBD 模式，分为核心（Core）、行为（Behavior）和驱动（Driver）三部分，并支持模块化设计，包括分组、控制器和操作。此外，ThinkJS 提供了灵活的配置功能，包括系统默认配置、应用配置、调试配置和模式配置，并支持 WebSocket 功能，通过配置可以实现数据的实时传输。框架还提供了文件上传和变量过滤器等功能，方便开发者处理复杂的数据解析和参数管理。

AI总结

《ThinkJS 1.2 中文文档》总结

ThinkJS 是一个高效、简单易用的 Node.js MVC 框架，基于 ES6 Promise 开发，支持异步编程。其核心特点包括：

1. **安装与准备**：
- 需要 Node.js 版本 >=0.10.x
- 通过 npm 或 cnpm 安装：`npm install -g thinkjs-cmd`
- verify 安装：`thinkjs -v`

2. **架构与设计**：
- 基于 **CBD（Core+Behavior+Driver）** 架构
- 支持 **MVC** 模式，URL 结构为 `/分组/控制器/操作/参数`
- 分组、控制器、操作 的逻辑分离，官方示例：`http://hostname:port/分组/控制器/操作/参数名/参数值`

3. **功能特性**：
- **自动启动服务**，支持 HTTP、命令行、WebSocket、Restful 等调用方式
- **Promise 支持**，简化异步编程
- 内置 **Db、Cache、Session** 等常用功能
- 开发模式下文件修改实时生效，无需重启

4. **WebSocket 支持**：
- 默认关闭，可通过配置 `use_websocket: true` 启用
- 支持 JSON-RPC 2.0 数据格式
- WebSocket 消息处理与 HTTP 请求逻辑一致

5. **数据解析与上传**：
- 支持 **JSON** 和 **querystring** 解析
- 自定义数据解析方式（如 XML）
- 支持表单和 AJAX 文件上传，解析结果存储在 `http.file` 对象中

6. **配置管理**：
- 配置文件层级：系统默认配置 > 应用配置 > 调试配置 > 模式配置
- 配置文件路径：`App/Conf/config.js`、`App/Conf/debug.js`、`App/Conf/mode.js`
- 配置加载顺序：后加载的配置覆盖前加载的配置

7. **项目管理**：
- 通过 `thinkjs .` 创建新项目
- 更新系统 ThinkJS 版本：`npm update -g thinkjs-cmd`
- 更新项目内 ThinkJS 版本：`npm update thinkjs`

8. **控制器与视图**：
- 基础控制器文件：`App/Lib/Controller/Home/IndexController.js`
- 支持渲染视图文件或直接输出字符串

9. **全局配置与变量过滤器**：
- 支持灵活的全局配置，可在服务启动时生效
- 提供变量过滤器功能，可通过 `Filter` 加载，简化参数处理逻辑

10. **WebSocket 稳定性**：
- 定期清理超时的 WebSocket 连接（默认 30 分钟）
- 开发环境（`APP_DEBUG`）下需谨慎处理 WebSocket 连接存储，防止缓存清理导致异常

ThinkJS 提供了灵活的配置和扩展机制，适合开发高效、可维护的 Node.js 应用程序。