ThinkJS 1.2 中文文档

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

摘要

ThinkJS是一款高效、简单易用的Node.js MVC框架，基于ES6 Promise开发，支持多种调用方式和模块化设计。文档详细介绍了其核心组件、行为机制、路由系统、数据解析方式、文件上传功能以及视图引擎的配置。框架采用CBD架构，核心包含通用函数库和系统配置，行为和标签机制用于扩展功能。ThinkJS支持WebSocket、JSON-RPC数据格式，以及多种模板引擎，适用于构建高效的应用。

AI总结

# ThinkJS 1.2 中文文档总结

## 1. 快速入门
- **简介**：ThinkJS 是一款高效、简单易用的 Node.js MVC 框架，基于 ES6 Promise 开发，支持异步编程。
- **特性**：
- 自动启动服务，支持 Http、命令行、WebSocket、Restful 等多种调用方式。
- CBD 架构，MVC 模式，封装了 Db、Cache、Session 等常用功能。
- 开发模式下文件修改后立即生效，无需重启。

## 2. 安装与创建项目
- 需要 Node.js 版本 ≥0.10.x。
- 安装命令：`npm install -g thinkjs-cmd`（可使用 cnpm 替代 npm）。
- 查看版本：`thinkjs -v`。

## 3. 核心组件
- 包含通用函数库、系统默认配置、核心类库等。
- 核心文件：
- `lib/Common/common.js`：通用函数库。
- `lib/Lib/Core/Think.js`：框架类。
- `lib/Lib/Core/Controller.js`：控制器基类。
- `lib/Lib/Core/Model.js`：模型基类。

## 4. 行为与标签
- **行为**：独立或整合到标签中执行的动作或事件。
- **标签**：一组行为的集合，按顺序执行，使用 Promise 控制后续行为。

## 5. 架构与模块化设计
- **CBD 模式**：核心保留关键部分，其他功能以驱动方式实现。
- **模块化设计**：
- URL 结构：`分组/控制器/操作/参数名/参数值`。
- 配置分组列表：`app_group_list`。
- 默认分组：`default_group`。

## 6. 数据校验
- 使用 JSON Schema 进行数据校验。
- 示例：在 Controller 中定义校验规则并进行数据验证。

## 7. WebSocket 支持
- 默认关闭 WebSocket 功能，开启配置：`use_websocket: true`。
- 使用 `websocket-driver` 模块实现 WebSocket 功能。

## 8. 数据格式
- 默认使用 JSON-RPC 2.0 规范。
- 支持通过 `querystring` 和 `application/json` 解析数据。
- 支持自定义解析方式，通过行为切面实现。

## 9. URL 过滤
- 去除 URL 前缀和后缀，使 pathname 更干净。
- 配置前缀和后缀过滤：`url_pathname_prefix` 和 `url_pathname_suffix`。

## 10. 路由识别
- 根据干净的 pathname 识别分组、控制器和操作。
- 分组必须在 `app_group_list` 配置中。

## 11. 文件上传
- 支持表单文件上传和 Ajax 文件上传。
- 配置参数：`post_max_file_size`、`post_max_fields` 等。

## 12. 视图模版引擎
- 默认使用 EJS 模版引擎。
- 支持 Jade 和 Swig，需手动安装。
- 配置参数：`tpl_engine_type`、`tpl_engine_config` 等。

## 13. 其他功能
- 反向代理支持。
- 获取原始 Request 和 Response 对象：`http.req` 和 `http.res`。

以上为《ThinkJS 1.2 中文文档》的核心内容总结。