ThinkJS 2.0 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: thinkjs.org

摘要

文档系统阐述了ThinkJS 2.0框架的核心功能和配置，包括国际化、多主题支持、模板引擎的使用与扩展、配置管理机制以及项目环境的不同配置。文档还介绍了如何通过Promise处理异步操作、使用事务处理数据库操作，并提供了模型的各种方法如查询、缓存、统计等。最后，文档还涵盖了如何安装ThinkJS、创建新项目以及使用ES6特性。

AI总结

《ThinkJS 2.0 Documentation》主要介绍了ThinkJS框架的功能、配置、模板使用、模型操作、控制器方法以及扩展特性。以下是文档的总结：

### 1. 模板与国际化
- **模板功能**：模板中可直接使用`http`和`controller`对象的属性和方法。例如，通过`controller.navType`访问控制器中设置的属性，通过`config`对象获取配置信息。
- **国际化支持**：通过`_()`函数在模板中获取多语言资源，资源定义在`src/common/config/locales/[lang].js`文件中。

### 2. 配置
- **灵活配置**：支持不同模块和环境（开发、测试、生产）使用不同的配置，配置文件为`config/config.js`。
- **模块化配置**：项目按模块划分，模块配置可继承`common`模块的配置。
- **环境切换**：环境类型包括`development`、`testing`、`production`，可在入口文件中设置当前环境。

### 3. 模型操作
- **CRUD功能**：提供`select()`、`where()`、`order()`、`page()`等方法进行数据库操作。
- **聚合函数**：支持`count()`、`sum()`、`max()`、`min()`、`avg()`等方法查询字段聚合值。
- **事务支持**：提供`startTrans()`、`commit()`、`rollback()`和`transaction()`方法进行事务操作。
- **缓存机制**：通过`cache()`方法设置查询缓存，缓存键默认由SQL生成。

### 4. 控制器
- **数据渲染**：提供`display()`、`jsonp()`、`json()`、`write()`、`end()`、`download()`等方法渲染响应。
- **状态码设置**：通过`status()`和`deny()`方法设置响应状态码。

### 5. 异步处理与Promise
- **回调转Promise**：使用`think.promisify`方法将回调式接口转换为Promise。
- **并行处理**：通过`think.parallelLimit`方法限制并发任务数量，避免文件描述符过多。

### 6. 中间件与扩展
- **预操作**：通过`__before`方法在动作执行前执行预操作逻辑。
- **动态类创建**：支持动态创建控制器和模型，`init`方法用于初始化。
- **模板引擎扩展**：支持自定义模板引擎，需实现`run`方法。

### 7. 命令工具
- **项目创建**：通过`thinkjs new`命令创建新项目，支持`--es6`模式。
- **升级与安装**：通过`npm install`命令安装或升级框架。
- **适配器扩展**：使用`thinkjs adapter`命令创建自定义适配器。

### 8. 环境与安装
- **Node.js依赖**：要求Node.js版本≥0.12.0，推荐版本4.2.1。
- **安装与验证**：通过`node -v`验证Node.js安装，使用`npm install`安装ThinkJS。

文档还列举了框架的更多功能，如日志处理、日期格式化、代码转换等，代码示例丰富，帮助开发者理解和使用框架。