#Database 数据库

Database 是数据库类型数据源（DataSource）的重要组成部分。每个数据库类型的数据源都会有一个对应的 Database 实例，可以通过 dataSource.db 访问。主数据源的数据库实例还提供了便捷的 app.db 别名。熟悉 db 的常用方法，是编写服务端插件的基础。

#Database 组成部分

一个典型的 Database 由以下部分组成：

• Collection：定义数据表结构。
• Model：对应 ORM 的模型（通常由 Sequelize 管理）。
• Repository：封装数据访问逻辑的仓库层，提供更高级的操作方法。
• FieldType：字段类型。
• FilterOperator：用于筛选的操作符。
• Event：生命周期事件和数据库事件。

#插件中的使用时机

#在 beforeLoad 阶段适合做的事情

此阶段不可以进行数据库操作，适合静态类的注册或事件监听。

• db.registerFieldTypes() — 自定义字段类型
• db.registerModels() — 注册自定义模型类
• db.registerRepositories() — 注册自定义仓库类
• db.registerOperators() — 注册自定义筛选操作符
• db.on() — 监听数据库相关事件

#在 load 阶段适合做的事情

此阶段所有前置的类定义和事件已经加载，再加载数据表就不会有缺失或遗漏。

• db.defineCollection() — 定义新的数据表
• db.extendCollection() — 扩展已有数据表配置

如果是用于定义插件的内置表，更推荐放在 ./src/server/collections 目录里，详见 Collections。

#数据操作

Database 提供两种主要方式访问和操作数据：

#通过 Repository 操作

const repo = db.getRepository('users');
const user = await repo.findOne({ filter: { id: 1 } });

Repository 层通常用于封装业务逻辑，例如分页、过滤、权限检查等。

#通过 Model 操作

const UserModel = db.getModel('users');
const user = await UserModel.findByPk(1);

Model 层直接对应 ORM 实体，适合执行较底层的数据库操作。

#哪些阶段可以进行数据库操作？

#Plugin 生命周期

#App 事件

#Database 事件/钩子