[Egg.js] egg-tx 接口级事务管理插件

egg-tx

一个 egg 事务插件，它支持 Mysql、Mongo 数据库，它能作到请求接口级别的事务管理。

依赖的插件

• 对于使用 Mysql 数据库你须要开启 egg-sequelize 插件。
• 对于使用 Mongo 数据库你须要开启 egg-mongoose 插件。

安装

$ npm i egg-tx --save
复制代码

开启插件

// {app_root}/config/plugin.js
exports.tx = {
  enable: true,
  package: 'egg-tx',
};
复制代码

配置

// {app_root}/config/config.default.js
exports.tx = {
    reqAction:['POST','PUT','DELETE'], 
    dbType:'mysql'
};
复制代码

• reqAction：将为指定动做的全部请求进行事务管理，该数组的值可为 GET、POST、PUT、DELETE、HEAD、PATCH、OPTIONS（默认值为 POST、PUT、DELETE）
• dbType：所使用的数据库类型，该值可为 mysql 或 mongo （默认值为 mysql）

使用例子

你能够经过 ctx.tx.session 获取到本次请求的事务会话对象，前提是它已经被事务管理器所管理。

mysql

await this.ctx.model.User.create(user, {
    transaction: this.ctx.tx.session,
});
复制代码

mongo

await this.ctx.model.User.insertMany([
  { username: 'lyTongXue', password: '123456' },
], { session: this.ctx.tx.session });
复制代码

注解

@tx

使用该注解的接口方法将会进行事务管理，即使 reqAction 配置项中未包含该动做类型的请求。

// {app_root}/app/controller/{controller_name}.js
/** * @tx */
async create(){
}
复制代码

@txIgnore

即使 reqAction 配置项中包含了该动做类型的请求，使用了该注解的接口方法将不会进行事务管理。

// {app_root}/app/controller/{controller_name}.js
/** * @txIgnore */
async index(){
}
复制代码

提问交流

一、接口方法的 jsDoc 是否有必定要求？

• jsDoc 必需要与方法"紧挨着"，如：

// --- 正确写法

/** * @TX */
async create(){
}

// --- 错误写法

/** * @TX */


async create(){
}
复制代码

请到 egg issues 异步交流。

License

MIT