ThinkJS 2.1 Documentation

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

摘要

文档详细介绍了ThinkJS 2.1框架的模型配置、数据库适配器、CRUD操作、环境配置、插件开发以及事务处理等功能。框架支持MySQL、MongoDB、PostgreSQL、SQLite等多种数据库，提供灵活的配置机制以适应不同项目环境。文档还涉及了如何通过不同的配置文件实现环境隔离，并介绍了插件开发的基本流程，包括创建插件目录、编写源代码、配置测试以及运行测试等。

AI总结

《ThinkJS 2.1 Documentation》中文总结

本文档主要介绍了ThinkJS框架的模型、配置、数据库支持、适配器扩展、国际化、配置机制以及插件开发等内容，以下是核心要点总结：

1. **模型配置与使用**：
- 数据库配置文件位于`src/common/config/db.js`，支持不同模块和环境的独立配置。
- 默认模型名称映射到数据库表名，表前缀默认为`think_`，可通过`tablePrefix`和`tableName`配置修改。
- 支持CURD（创建、读取、更新、删除）操作，包括基本查询、分页、聚合操作（如GROUP BY、HAVING、JOIN、UNION、DISTINCT）以及事务操作。

2. **数据库支持**：
- 支持MySQL、MongoDB、PostgreSQL、SQLite等多种数据库。
- 配置示例：
- MySQL：需设置主机、端口、数据库名、用户和密码。
- SQLite：支持内存和文件存储，文件默认存储路径为`src/common/runtime/sqlite`。
- PostgreSQL：通过pq模块支持，无需额外配置，API与MySQL一致。

3. **适配器扩展**：
- 框架默认提供如Cache、Session、WebSocket等适配器，支持通过`thinkjs adapter`命令创建自定义适配器。
- 示例：通过命令`thinkjs adapter template/dot`创建Template适配器。

4. **国际化支持**：
- 提供多语言支持，可通过`_<%= _('title') %>`方式实现本地化。
- 更多国际化信息请参考相关文档。

5. **配置机制**：
- 支持模块化配置，项目可分为`common`模块和其他模块，后者可继承`common`配置。
- 支持三种环境模式：`development`、`testing`、`production`，可在入口文件中设置。
- 配置文件路径包括`config/config.js`、`config/[name].js`和`config/env/[mode].js`。

6. **插件开发**：
- 支持创建Middleware和Adapter插件，插件名称建议以`think-`开头。
- 插件目录结构包括`src`、`test`、`.eslintrc`、`.npmignore`、`.travis.yml`、`package.json`和`README.md`。
- 开发流程：创建插件目录 → 安装依赖 → 实时编译 → 运行单元测试。

以上总结涵盖了ThinkJS框架的主要功能模块和配置方法，旨在为开发者提供快速了解和使用ThinkJS的参考。