midway-fatcms 0.0.1-beta.55 → 0.0.1-beta.57

package/src/libs/crud-pro/models/ExecuteContextFunc.ts

@@ -0,0 +1,96 @@
+import { IConnectionPool, IRequestCfgModel, IRequestModel } from '../interfaces';
+import { ExecuteContext } from './ExecuteContext';
+import { SqlCfgModel } from './SqlCfgModel';
+import { RequestCfgModel } from './RequestCfgModel';
+import { RequestModel } from './RequestModel';
+import { KeysOfAuthType } from './keys';
+import { CommonException, Exceptions } from '../exceptions';
+import { MixinUtils } from '../utils/MixinUtils';
+
+export interface IExecuteContextFunc {
+  setExecuteContext(exeCtx: ExecuteContext);
+  getExecuteContext(): ExecuteContext;
+  getConnectionPool(sqlCfgModel: SqlCfgModel): Promise<IConnectionPool>;
+  getFunctionMap(): any;
+  validateByAuthCfg(cfgModel: RequestCfgModel, reqModel: RequestModel): Promise<any>;
+  afterExecuteSQLList(): Promise<any>;
+  beforeExecuteSQLList(reqJson: IRequestModel, cfgJson: IRequestCfgModel): Promise<any>;
+}
+
+export class BaseExecuteContextFunc implements IExecuteContextFunc {
+  private executeContext: ExecuteContext;
+  async getConnectionPool(sqlCfgModel: SqlCfgModel): Promise<IConnectionPool> {
+    throw 'getConnectionPool not implemented';
+  }
+
+  getFunctionMap(): any {
+    return {};
+  }
+
+  /**
+   * 校验请求权限
+   * @param cfgModel
+   * @param reqModel
+   */
+  async validateByAuthCfg(cfgModel: RequestCfgModel, reqModel: RequestModel): Promise<any> {
+    if (cfgModel.authType === KeysOfAuthType.free || !cfgModel.authType) {
+      return; // 无需校验
+    }
+
+    const visitor = reqModel.visitor;
+
+    if (!visitor.isLogin) {
+      throw new CommonException(Exceptions.NOT_LOGIN, '用户没有登陆');
+    }
+
+    // 超级管理员 无需校验
+    if (visitor.isSuperAdmin === true) {
+      return;
+    }
+
+    if (cfgModel.authType === KeysOfAuthType.byFuncCode) {
+      const funcCodes = cfgModel.authConfig;
+      if (MixinUtils.isEmpty(funcCodes)) {
+        throw new CommonException(Exceptions.CFG_AUTH_CODE_EMPTY, '缺少权限编码配置');
+      }
+      if (!MixinUtils.hasAny(visitor.functionCodes, funcCodes)) {
+        throw new CommonException(Exceptions.NO_AUTH, '缺少权限: ' + JSON.stringify(funcCodes));
+      }
+    }
+
+    if (cfgModel.authType === KeysOfAuthType.byRoleCode) {
+      const roleCodes = cfgModel.authConfig;
+      if (MixinUtils.isEmpty(roleCodes)) {
+        throw new CommonException(Exceptions.CFG_AUTH_CODE_EMPTY, '缺少角色编码配置');
+      }
+      if (!MixinUtils.hasAny(visitor.roleCodes, roleCodes)) {
+        throw new CommonException(Exceptions.NO_AUTH, '缺少角色: ' + JSON.stringify(roleCodes));
+      }
+    }
+  }
+
+  /**
+   * SQL执行完之后做一些额外操作，可以处理一下将要返回的数据。
+   * @param exeCtx
+   */
+  afterExecuteSQLList(): Promise<any> {
+    return null;
+  }
+
+  /**
+   * 在执行之前可以根据业务需要修改需要执行的内容
+   * @param reqJson
+   * @param cfgJson
+   */
+  beforeExecuteSQLList(reqJson: IRequestModel, cfgJson: IRequestCfgModel): Promise<any> {
+    return Promise.resolve();
+  }
+
+  getExecuteContext(): ExecuteContext {
+    return this.executeContext;
+  }
+
+  setExecuteContext(executeContext: ExecuteContext) {
+    this.executeContext = executeContext;
+  }
+}

package/src/libs/crud-pro/models/FuncContext.ts

@@ -0,0 +1,21 @@
+import { RequestModel } from './RequestModel';
+
+class FuncContext {
+  /**
+   * 执行结果:
+   *  在validate/update阶段为空
+   *  在execute阶段不为空
+   */
+  resModel: any; //通过 res.xx.xx获取
+
+  /**
+   * 请求中的数据
+   */
+  reqModel: RequestModel; //通过 req.xx.xx获取
+
+  /**
+   * 当前行中的数据
+   */
+  currentValue: any; // 当前值， 使用 $current获取
+}
+export { FuncContext };

package/src/libs/crud-pro/models/RequestCfgModel.ts

@@ -0,0 +1,141 @@
+import { ColumnRelation, IFuncCfgModel, IRequestCfgModel, ISqlCfgModel, IValidatorCfgItem } from '../interfaces';
+import { SqlCfgModel } from './SqlCfgModel';
+import { MixinUtils } from '../utils/MixinUtils';
+import { KeysOfAuthType, KeysOfSimpleSQL, KeysOfSqlResPicker, SqlDbType } from './keys';
+import { DEFAULT_MAX_LIMIT } from '../defaultConfigs';
+//
+// const columnsRelation = [
+//   {
+//     relatedType: 'dict',
+//     relatedCode: 'SexEnum',
+//     sourceColumns: ['sex'],
+//     targetColumns: [{ from: 'label', to: 'sexLabel' }],
+//   },
+//   {
+//     relatedType: 'userBasic',
+//     // relatedCode: 'SexEnum',
+//     sourceColumns: ['created_by'],
+//     targetColumns: [{ from: 'userNick', to: 'created_by_user_nick' }],
+//   },
+//   {
+//     relatedType: 'sysConfig',
+//     relatedCode: 'SexEnum',
+//     sourceColumns: ['sex'],
+//     targetColumns: [{ from: 'userNick', to: 'created_by_user_nick' }],
+//   },
+// ];
+
+/**
+ *  sqlSimpleName/sqlCfgList 二选一
+ *  sqlCfgList 优先级高于 sqlSimpleName
+ *  如果设置了sqlCfgList，则sqlSimpleName不再生效。
+ */
+class RequestCfgModel {
+  columns?: string[]; // "columns": "id,name,age,sex,addr", 可以为空，为空代表 星号*
+  columnsRelation?: ColumnRelation[]; //通过列关联其他信息
+  uniqueColumn?: string[]; //postgres的惟一键。insert on CONFLICT DO UPDATE
+
+  sqlTable: string; // 可以为空. originSql中不包含@@table时可以为空
+  sqlSchema?: string; // 可以为空
+  sqlDatabase?: string; // 可以为空，用此字段进行connection的选择和切换。配合getBizConnectionPool使用
+  sqlDbType?: SqlDbType; // 数据库类型，mysql(默认) 、postgres
+  maxLimit = DEFAULT_MAX_LIMIT; // 最大一次性返回的数量
+  method: string; // 不能为空
+  transactionEnable: boolean; // 是否开启事务，默认不开启，每条语句都是autocommit
+  transactionIsolation: number; // 事务隔离级别
+  sqlSimpleName: KeysOfSimpleSQL; // 二选一 sqlSimpleName  sqlCfgList
+  sqlCfgList: SqlCfgModel[]; // 二选一 sqlSimpleName  sqlCfgList
+  functionCfg: Record<string, IFuncCfgModel>;
+
+  /**
+   *  key 为update哪个字段。 如：{'data.userName': { constString: 'zhangsan' }}
+   */
+  updateCfg: Record<string, IFuncCfgModel>;
+
+  /**
+   *  key 为update哪个字段。 如：{'data.userName': [{ constString: 'zhangsan' },'required']}
+   *  value 是一个数组，允许添加多个校验器。
+   */
+  validateCfg: Record<string, IValidatorCfgItem[]>;
+
+  /**
+   * key为data或condition；value为字段数组
+   * 如：{
+   *   allowCfg: {
+   *      data: ['id','name','age']
+   *   }
+   * }
+   */
+  allowCfg: Record<string, string[]>;
+
+  /**
+   * key为data或condition；value为字段数组
+   * 如：{
+   *   rejectCfg: {
+   *      data: ['id','name','age']
+   *   }
+   * }
+   */
+  rejectCfg: Record<string, string[]>;
+
+  /**
+   * 鉴权类型；free无需鉴权，login仅登录即可，byRoleCode校验角色，byFuncCode校验功能点
+   */
+  authType: KeysOfAuthType;
+
+  /**
+   * 鉴权类型为byRole或byFunc时，额外的配置。角色code或功能点code
+   */
+  authConfig: string[];
+
+  constructor(json: Partial<IRequestCfgModel>) {
+    Object.assign(this, json);
+    this.columns = MixinUtils.parseColumns(json.columns);
+    this.authConfig = this.parseAuthConfig(json.authConfig);
+    this.sqlCfgList = [];
+    this.addSqlCfgModelList(json.sqlCfgList);
+  }
+
+  private parseAuthConfig(cfg: any): string[] {
+    if (!cfg) {
+      return null;
+    }
+    if (Array.isArray(cfg)) {
+      return cfg;
+    }
+    if (typeof cfg === 'string') {
+      return [cfg];
+    }
+    return null;
+  }
+
+  public addSqlCfgModel(resName: string, originSql: string, resPicker?: KeysOfSqlResPicker, executeWhenFunCfg?: IFuncCfgModel) {
+    const model = new SqlCfgModel({ resName, originSql });
+    if (resPicker) {
+      model.resPicker = resPicker;
+    }
+    if (executeWhenFunCfg) {
+      model.executeWhen = executeWhenFunCfg;
+    }
+    this.addSqlCfgModelIf(model);
+  }
+
+  private addSqlCfgModelList(list: ISqlCfgModel[]) {
+    if (!list || !Array.isArray(list)) {
+      return;
+    }
+    for (let i = 0; i < list.length; i++) {
+      const listElement = list[i];
+      const model = new SqlCfgModel(listElement);
+      this.addSqlCfgModelIf(model);
+    }
+  }
+
+  private addSqlCfgModelIf(model: SqlCfgModel) {
+    if (!this.sqlCfgList) {
+      this.sqlCfgList = [];
+    }
+    this.sqlCfgList.push(model);
+  }
+}
+export { RequestCfgModel };

package/src/libs/crud-pro/models/RequestModel.ts

@@ -0,0 +1,141 @@
+import * as _ from 'lodash';
+import { ILimitOffset, IOrderByItem, IRequestModel, IVisitor } from '../interfaces';
+import { MixinUtils } from '../utils/MixinUtils';
+import { CommonException, Exceptions } from '../exceptions';
+import { DEFAULT_LIMIT } from '../defaultConfigs';
+
+class RequestModel {
+  visitor: IVisitor;
+
+  method: string;
+  columns?: string[]; // "columns": "id,name,age,sex,addr",
+  condition?: Record<string, any>;
+  data?: Record<string, any>;
+  limit: number;
+  offset: number;
+  orderBys?: IOrderByItem[];
+
+  constructor(req: IRequestModel, visitor: IVisitor) {
+    Object.assign(this, req);
+    this.visitor = visitor;
+    this.columns = MixinUtils.parseColumns(req.columns);
+    this.orderBys = this.parseOrderBys(req.orderBy);
+    const limitOffset = this.parseOffsetList(req);
+    this.limit = limitOffset.limit;
+    this.offset = limitOffset.offset;
+  }
+
+  private parseOrderBys(orderByStr: any): IOrderByItem[] {
+    if (MixinUtils.isEmpty(orderByStr)) {
+      return [];
+    }
+
+    if (Array.isArray(orderByStr)) {
+      return orderByStr
+        .map(obj => {
+          if (typeof obj === 'string') {
+            return { fieldName: obj, orderType: 'asc' };
+          }
+
+          const { fieldName, orderType = 'asc' } = obj;
+          if (fieldName) {
+            return { fieldName, orderType };
+          }
+
+          return null;
+        })
+        .filter(o => {
+          return !!o;
+        });
+    }
+
+    const orderByResult: IOrderByItem[] = [];
+    const orderByArray = orderByStr
+      .split(',')
+      .map(s => {
+        return s.trim();
+      })
+      .filter(s => !!s);
+
+    if (MixinUtils.isEmpty(orderByArray)) {
+      return orderByResult;
+    }
+
+    for (let i = 0; i < orderByArray.length; i++) {
+      const orderByItem = orderByArray[i];
+      let orderType = 'asc'; //默认升序
+      let fieldName = orderByItem;
+
+      if (orderByItem.endsWith('+')) {
+        // 升序
+        fieldName = orderByItem.substring(0, orderByItem.length - 1);
+        orderType = 'asc'; //升序
+      } else if (orderByItem.endsWith('-')) {
+        //降序
+        fieldName = orderByItem.substring(0, orderByItem.length - 1);
+        orderType = 'desc'; //降序
+      }
+
+      fieldName = fieldName.trim();
+
+      if (MixinUtils.isEmpty(fieldName) || !MixinUtils.isValidFieldName(fieldName)) {
+        throw new CommonException(Exceptions.REQUEST_MODEL_PARSE_ORDER_BY_FAILED, orderByItem);
+      }
+
+      orderByResult.push({ fieldName, orderType });
+    }
+
+    return orderByResult;
+  }
+
+  private parseOffsetList(req: IRequestModel): ILimitOffset {
+    const { limit, offset, pageSize, pageNo } = req;
+
+    const limitOffset: ILimitOffset = {
+      limit: DEFAULT_LIMIT,
+      offset: 0,
+    };
+
+    if (typeof limit === 'number') {
+      limitOffset.limit = limit;
+    }
+    if (typeof offset === 'number') {
+      limitOffset.offset = offset;
+    }
+
+    if (typeof pageNo === 'number' && typeof pageSize === 'number' && pageNo > 0 && pageSize > 0) {
+      limitOffset.limit = pageSize;
+      limitOffset.offset = (pageNo - 1) * pageSize;
+    }
+
+    return limitOffset;
+  }
+
+  /**
+   * 获取对象数据类型
+   * @param attrName
+   */
+  getCondOrDataJsonObject(attrName: string): any {
+    if (attrName.startsWith('data') || attrName.startsWith('condition')) {
+      const jsonObject = _.get(this, attrName);
+      if (!jsonObject) {
+        return null;
+      }
+      if (typeof jsonObject !== 'object' && !Array.isArray(jsonObject)) {
+        throw new CommonException(Exceptions.RUN_GET_COND_OR_DATA_JSONOBJECT, attrName);
+      }
+      return jsonObject;
+    }
+    throw new CommonException(Exceptions.RUN_GET_COND_OR_DATA_JSONOBJECT, attrName);
+  }
+
+  /**
+   * 获取基本数据类型
+   * @param attrName
+   */
+  getJsonObjectValue(attrName: string): any {
+    return _.get(this, attrName);
+  }
+}
+
+export { RequestModel };

package/src/libs/crud-pro/models/ResModel.ts

@@ -0,0 +1,19 @@
+interface ResModelAffected {
+  insertId?: string | number;
+  affectedRows: number;
+}
+
+interface ResModelStandard {
+  row?: any;
+  rows?: any[];
+  total_count?: number;
+  affected?: ResModelAffected;
+  insert_affected?: ResModelAffected;
+  update_affected?: ResModelAffected;
+}
+
+type ResModelFlexible = ResModelStandard & {
+  [key: string]: any;
+};
+
+export { ResModelAffected, ResModelStandard, ResModelFlexible };

package/src/libs/crud-pro/models/ServiceHub.ts

@@ -0,0 +1,32 @@
+import { RequestCfgModel } from './RequestCfgModel';
+import { RequestModel } from './RequestModel';
+import { SqlCfgModel } from './SqlCfgModel';
+import { ExecuteContext } from './ExecuteContext';
+import { IFuncCfgModel, IRequestCfgModel, ITableMeta } from '../interfaces';
+import { FuncContext } from './FuncContext';
+
+export interface ICurdProServiceHub {
+  getExecuteContext(): ExecuteContext;
+
+  validateByAllow(cfgModel: RequestCfgModel, reqModel: RequestModel);
+
+  validateByReject(cfgModel: RequestCfgModel, reqModel: RequestModel);
+
+  validateByCfg(cfgModel: RequestCfgModel, reqModel: RequestModel);
+
+  validateByAuthCfg(cfgModel: RequestCfgModel, reqModel: RequestModel): void;
+
+  updateByCfg(cfgModel: RequestCfgModel, reqModel: RequestModel);
+
+  getCachedCfgByMethod(method: string, isEnableCache: boolean): Promise<IRequestCfgModel>;
+
+  generateSQLList(exeCtx: ExecuteContext): Promise<void>;
+
+  executeSqlCfgModels(exeCtx: ExecuteContext): Promise<void>;
+
+  convertOriginToExecuteSql(sqlCfgModel: SqlCfgModel): Promise<void>;
+
+  executeFuncCfg(tmpFunCfg: IFuncCfgModel, exeFunCtx: FuncContext): string;
+
+  getTableMeta(sqlCfgModel: SqlCfgModel): Promise<ITableMeta>;
+}

package/src/libs/crud-pro/models/SqlCfgModel.ts

@@ -0,0 +1,52 @@
+import { ColumnRelation, IFuncCfgModel, ISqlCfgModel } from '../interfaces';
+import { MixinUtils } from '../utils/MixinUtils';
+import { KeyOfCrudTypes, KeysOfSqlResPicker, SqlDbType } from './keys';
+import { parseJsonObject } from '../../utils/functions';
+
+const { isEmpty } = MixinUtils;
+
+class SqlCfgModel {
+  columns: string[]; // "columns": "id,name,age,sex,addr",
+  columnsRelation?: ColumnRelation[]; //只能关联基本信息：如枚举值
+  sqlTable: string; // 可以为空. originSql中不包含@@table时可以为空
+  sqlSchema?: string; // 可以为空
+  sqlDatabase?: string; // 可以为空，用此字段进行connection的选择和切换。配合getBizConnectionPool使用
+  sqlDbType?: SqlDbType; // 数据库类型，mysql(默认) 、postgres
+  maxLimit: number; // 最大一次性返回的数量
+  resName: string;
+  resPicker: KeysOfSqlResPicker;
+  originSql: string; // 有特殊占位符的SQL, 原始的SQL constructor(resName: string, originSql: string) {}
+  validate: IFuncCfgModel; //执行前，进行校验，校验不通过就抛出异常. 校验函数可以返回 boolean或直接抛出异常
+  executeWhen: IFuncCfgModel; //满足表达式的结果，才能执行。 默认：true 校验函数必须返回 booleansetResPicker(resPicker: string) {}
+  executeSql: string; // 可以运行的SQL
+  executeSqlArgs: any[]; //可以运行的SQL的参数setExecuteWhen(executeWhenFunCfg: IFuncCfgModel) {}
+  crudType: KeyOfCrudTypes = null;
+
+  constructor(json: Partial<ISqlCfgModel>) {
+    Object.assign(this, json);
+    this.columns = MixinUtils.parseColumns(json.columns);
+    this.executeWhen = parseJsonObject(json.executeWhen);
+  }
+
+  public getCrudType(): KeyOfCrudTypes {
+    if (!this.crudType) {
+      const sql = this.executeSql.trim().toUpperCase();
+      if (isEmpty(sql)) {
+        this.crudType = KeyOfCrudTypes.EMPTY_SQL;
+      } else if (sql.startsWith(KeyOfCrudTypes.SELECT)) {
+        this.crudType = KeyOfCrudTypes.SELECT;
+      } else if (sql.startsWith(KeyOfCrudTypes.UPDATE)) {
+        this.crudType = KeyOfCrudTypes.UPDATE;
+      } else if (sql.startsWith(KeyOfCrudTypes.DELETE)) {
+        this.crudType = KeyOfCrudTypes.DELETE;
+      } else if (sql.startsWith(KeyOfCrudTypes.INSERT)) {
+        this.crudType = KeyOfCrudTypes.INSERT;
+      } else {
+        this.crudType = KeyOfCrudTypes.NOT_CRUD;
+      }
+    }
+    return this.crudType;
+  }
+}
+
+export { SqlCfgModel };

package/src/libs/crud-pro/models/SqlSegArg.ts

@@ -0,0 +1,13 @@
+class SqlSegArg {
+  sql: string;
+  args: any[];
+
+  constructor(sql: string, args?: any[]) {
+    this.sql = sql;
+    if (args) {
+      this.args = args;
+    }
+  }
+}
+
+export { SqlSegArg };

package/src/libs/crud-pro/models/Transaction.ts

@@ -0,0 +1,81 @@
+import { IConnectionPool, IPoolConnectionClient } from '../interfaces';
+import { SqlDbType } from './keys';
+import { TransactionMySQL } from './TransactionMySQL';
+import { TransactionPostgres } from './TransactionPostgres';
+import { TransactionSqlServer } from './TransactionSqlServer';
+
+class Transaction {
+  private transactionMySQL: TransactionMySQL = new TransactionMySQL();
+  private transactionPostgres: TransactionPostgres = new TransactionPostgres();
+  private transactionSqlServer: TransactionSqlServer = new TransactionSqlServer();
+  private isReleased = false;
+
+  private getTxObj(pool: IConnectionPool): TransactionMySQL | TransactionPostgres | TransactionSqlServer {
+    if (pool.dbType === SqlDbType.postgres) {
+      return this.transactionPostgres;
+    }
+
+    if (pool.dbType === SqlDbType.sqlserver) {
+      return this.transactionSqlServer;
+    }
+
+    if (!pool.dbType || pool.dbType === SqlDbType.mysql) {
+      return this.transactionMySQL;
+    }
+    return null;
+  }
+
+  /**
+   * 获取链接对象
+   * @param pool
+   */
+  public async getTxConnection(pool: IConnectionPool): Promise<IPoolConnectionClient> {
+    if (this.isReleased) {
+      const msg = '[Transaction] getTxConnection error, the txObject is isReleased, please check your code . DB request must be await';
+      console.error(msg);
+      throw new Error(msg);
+    }
+
+    const txObj = this.getTxObj(pool);
+    return txObj.getTxConnection(pool);
+  }
+
+  /**
+   * 开始事务
+   */
+  public beginTx() {
+    this.transactionMySQL.beginTx();
+    this.transactionPostgres.beginTx();
+    this.transactionSqlServer.beginTx();
+  }
+
+  /**
+   * 提交事务
+   */
+  public async commitTx() {
+    await this.transactionMySQL.commitTx();
+    await this.transactionPostgres.commitTx();
+    await this.transactionSqlServer.commitTx();
+  }
+
+  /**
+   * 事务回滚
+   */
+  public async rollbackTx() {
+    await this.transactionMySQL.rollbackTx();
+    await this.transactionPostgres.rollbackTx();
+    await this.transactionSqlServer.rollbackTx();
+  }
+
+  /**
+   * 释放连接
+   */
+  public async releaseTx() {
+    await this.transactionMySQL.releaseTx();
+    await this.transactionPostgres.releaseTx();
+    await this.transactionSqlServer.releaseTx();
+    this.isReleased = true;
+  }
+}
+
+export { Transaction };

package/src/libs/crud-pro/models/TransactionMySQL.ts

@@ -0,0 +1,79 @@
+import { PoolConnection, Pool } from 'mysql2/promise';
+import { IConnectionPool } from '../interfaces';
+
+class TransactionMySQL {
+  private isBeginTransaction = false;
+  private connectionMap: Record<string, PoolConnection> = {};
+
+  /**
+   * 获取链接对象
+   * @param pool
+   */
+  public async getTxConnection(pool: IConnectionPool): Promise<PoolConnection> {
+    let connection = this.connectionMap[pool.poolName];
+    if (!connection) {
+      const poolInstance: Pool = pool.poolInstance as any;
+      connection = await poolInstance.getConnection();
+      this.connectionMap[pool.poolName] = connection;
+      // 开启了事务
+      if (this.isBeginTransaction) {
+        await connection.beginTransaction();
+      }
+    }
+    return connection;
+  }
+
+  /**
+   * 开始事务
+   */
+  public beginTx() {
+    this.isBeginTransaction = true;
+  }
+
+  /**
+   * 提交事务
+   */
+  public async commitTx() {
+    if (!this.isBeginTransaction) {
+      return;
+    }
+    const connections = Object.values(this.connectionMap);
+    for (let i = 0; i < connections.length; i++) {
+      const connection = connections[i];
+      await connection.commit();
+    }
+  }
+
+  /**
+   * 事务回滚
+   */
+  public async rollbackTx() {
+    if (!this.isBeginTransaction) {
+      return;
+    }
+    const connections = Object.values(this.connectionMap);
+    for (let i = 0; i < connections.length; i++) {
+      const connection = connections[i];
+      await connection.rollback();
+    }
+  }
+
+  /**
+   * 释放连接
+   */
+  public async releaseTx() {
+    // 不管有没有开启事务，都要释放连接。
+    const connections = Object.values(this.connectionMap);
+    for (let i = 0; i < connections.length; i++) {
+      const connection = connections[i];
+      try {
+        await connection.release();
+      } catch (e) {
+        console.error(e);
+      }
+    }
+    this.connectionMap = {};
+  }
+}
+
+export { TransactionMySQL };