使用Class二次封装sequelize （nodejs、next、nuxt操作数据库）
一、前言
最近是在做NextJS全栈，避免不了去操作数据库。sequelize 是一个NodeJS操作数据的ORM框架，可以有效避免原生SQL语句导致的SQL注入漏洞。
但是原生的sequelize写起来比较繁琐，且对详细的ts支持并不是很好，所以我二次封装了一个，简化了一些操作
而且一个项目肯定不止链接一个数据库，所以使用class来封装，才能达到代码复用的效果
只需要定义好数据库的ts接口，就可以获得良好的代码提示
二、封装class源码
import { CreateOptions, DestroyOptions, FindOptions, Model, ModelAttributes, ModelOptions, ModelStatic, Options, Sequelize, UpdateOptions } from 'sequelize'
import mysql2 from 'mysql2'
/**分页查询 - 基础返回数据 */
export interface paging {
/**总条数 */
count: number
/**当前页数（用户传来的） */
page: number
/**当前一页个数 （查到多少就是多少） */
size: number,
/**数据列表 */
list: T[]
}
/**数据库基础类
* @template D 泛型D的键，代表数据库的表名，值为该表对应的列及其类型
* @template tablename 泛型tablename，代表当前数据库有哪些表。不需要填写, 仅用于内部使用
*/
class Database, tablename extends string = Extract> {
/**sequelize实例，用于操作数据库 */
sequelize: Sequelize
/**存放模型， 相当于this.sequelize.models，简化路径。如果有些操作是已封装的做不到的事，就从这里取出对应的表，来进行操作 */
modelMap: Record>
/**数据库基础类 - 构造函数
* @param username 用户名
* @param password 密码
* @param database 数据库名
* @param options 构造sequelize的可选配置项，详见ts类型。 不填则默认host为localhost
*/
constructor(username: string, password: string, database: string, options?: Options) {
this.sequelize = new Sequelize(database, username, password, Object.assign({
dialect: 'mysql',//基于MySQL数据库
dialectModule: mysql2,//在nextjs中，不填这个会导致报错“需要手动导入MySQL2包” 。填了就会导致控制台出现一堆提示污染眼睛，但是没办法，不保存就行，污染眼睛随便吧： Critical dependency: the request of a dependency is an expression Import trace for requested module:
}, options || {}));
this.modelMap = this.sequelize.models
// console.log('正在new', database);
// this.test(database)
}
/**测试数据库链接是否正常 */
test = async (databaseName: string = '') => {
let log = `与${databaseName}数据库的连接`
try {
await this.sequelize.authenticate();
console.log(log + '正常');
return log + '正常'
} catch (error) {
console.error(log + '失败', error);
return Promise.reject(log + '失败')
}
}
/**创建模型，也就是初始化这个数据库有哪些表
* @tip 关于参数的详细解释，可以看 https://blog.csdn.net/weixin_41229588/article/details/106646315
* @param modelName 模型名称，只能是泛型D中的key
* @param attributes 模型中包含都数据，每一个数据映射对应表中都每一个字段。键只能是泛型D中的对应table名下的key
* @param options 模型（表）的设置，比如设置不要 createdAt 和 updatedAt 字段，就使用 timestamps: false
* @description 关于模型的定义：用来表述（描述）数据库表字段信息的对象，每一个模型对象表示数据库中的一个表，后续对数据库的操作都是通过对应的模型对象来完成的。 https://sequelize.org/docs/v6/core-concepts/model-basics/
* @template T 不需要填写泛型,仅用于内部推断
* @template M 不需要填写泛型,仅用于内部推断
*/
createModel = (modelName: T, attributes: ModelAttributes, options?: ModelOptions) => {
return this.sequelize.define(modelName, attributes, Object.assign({ freezeTableName: true, timestamps: false }, options)) // freezeTableName强制表名等于模型名，timestamps不添加时间戳
}
/**增加数据
* @param tableName 要添加的表名
* @param newData 要添加的新数据
* @param config 其他配置项，比如fields属性可以设置“只保存哪个”，详见 https://www.sequelize.cn/core-concepts/model-querying-basics
* @returns 返回添加后得到的数据
* @template T 泛型T无需填写，仅供内部使用，代表表名
*/
add = async (tableName: T, newData: Omit, config?: CreateOptions): Promise => {
try {
if (!this.modelMap[tableName]) throw Error(`该表[${tableName}]不存在`)
const res = await this.modelMap[tableName].create(newData, config) as D[T]
return res
} catch (error) {
console.error('添加数据失败', error);
return Promise.reject(error)
}
}
/**查询数据。
* @param tableName 要查询的表名
* @param options 查询配置项，使用attributes、where、order等来进行筛选和排序等，注意里面的字段需要是数据库有的。详见 https://www.sequelize.cn/core-concepts/model-querying-basics
* @returns 查询到的数据数组 。注意，查询出来的数据，如果直接返回给前端则不用处理，如果想在服务端使用这些数据，需要注意这些数据还包含数据库的一些其他内容（可以打印来看），**想使用请深拷贝一份！**
* @template T 无需传递，可以自动识别
*/
findAll = async (tableName: T, options?: FindOptions): Promise => {
try {
if (!this.modelMap[tableName]) throw Error(`该模型[${tableName}]不存在，如果确定该表存在，请先使用createModel创建模型`)
const res = await this.modelMap[tableName].findAll(options) as D[T][]
return res
} catch (error) {
console.error('查询失败', error);
return Promise.reject(error)
}
}
/**更新数据
* @param tableName 表名
* @param newData 更新后的数据，想更新哪个填哪个。
* @param target 更新的目标，可以在里面填where语句等，详见 https://www.sequelize.cn/core-concepts/model-querying-basics#简单-update-查询
* @returns 更新的个数，是个数字数组，比如更新三个就是 [3] 。 如果没修改成功，需要手动写判断。
* @example if(res[0] === 0) throw new rejectData(code.BAD_REQUEST, '未找到该用户')
* @template T 泛型T无需填写，仅供内部使用，代表表名
*/
update = async (tableName: T, newData: Partial, target: Omit, 'returning'>) => {
try {
if (!this.modelMap[tableName]) throw Error(`该表[${tableName}]不存在`)
const res = await this.modelMap[tableName].update(newData, target)
return res
} catch (error) {
console.error('更新失败', error);
return Promise.reject(error)
}
}
/**删除数据。**慎用！！**
* @param tableName 表名
* @param options 删除配置选项。**慎用** 详细配置大体见https://www.sequelize.cn/core-concepts/model-querying-basics
* @returns 删除的个数。number
*/
delete = async (tableName: tablename, options: DestroyOptions) => {
try {
if (!options) throw TypeError('请传递删除选项')
if (!this.modelMap[tableName]) throw Error(`该表[${tableName}]不存在`)
return await this.modelMap[tableName].destroy(options)
} catch (error) {
console.error('删除失败', error);
return Promise.reject(error)
}
}
/**分页查询
* @param tableName 表名
* @param page 当前页数
* @param size 一页个数
* @param otherOptions 其它配置项
* @returns
*/
findByPage = async (tableName: T, page: number, size: number, otherOptions?: FindOptions): Promise> => {
try {
if (!this.modelMap[tableName]) throw Error(`该模型[${tableName}]不存在，如果确定该表存在，请先使用createModel创建模型`)
const res = await this.modelMap[tableName].findAndCountAll(Object.assign({
offset: Number((page - 1) * size), // 查询的起始下标
limit: Number(size) // 查询的条数
}, otherOptions))
return {
count: res.count,// 数据总条数
list: res.rows as D[T],// 查询的到数据
page,
size: res.rows.length
}
} catch (error) {
console.error('分页查询', error);
return Promise.reject(error)
}
}
/**随机获取指定数量的数据 */
randomFind = async (tableName: T, limit: number, otherOptions?: FindOptions): Promise => {
try {
if (!this.modelMap[tableName]) throw Error(`该模型[${tableName}]不存在，如果确定该表存在，请先使用createModel创建模型`)
const res = await this.findAll(tableName as any, Object.assign({
order: Sequelize.literal('RAND()'), // 随机排序
limit, // 获取指定量的数据
}, otherOptions))
return res
} catch (error) {
console.error('随机获取指定数量的数据', error);
return Promise.reject(error)
}
}
}
export default Database
三、使用方法
1.创建实例
一个数据库对应一个实例，多个数据库就需要创建多个实例。下面以一个实例为示例
· 定义数据库interface
为了让接下来写的代码有良好的ts支持，需要先定义好这个数据库的接口，每个表有哪些字段
// localhost_test.ts
import { DataTypes } from "sequelize"
import Database from "./sequelize"
/**本数据库的表名列表 */
interface tables {
/**user表 */
user: {
/**id */
id: number,
/**姓名 */
name: string,
/**年龄 */
age: number,
},
/**其它测试表 */
ohter: {
/**测试字段 */
test: string
}
}
// ...· 创建实例
// localhost_test.ts
// 承接上文
/**本地-数据库名为test的测试数据库 */
const localhost_test = new Database("root", "admin", "test");//分别是用户名，密码，数据库名，其它配置选填 （见class的构造函数）
// ... · 配置数据表（创建模型）
要想后面能使用，还需要配置数据表，也就是原生sequelize中的 “创建模型”
//配置数据表
localhost_test.createModel('user', {
id: {
allowNull: false,
autoIncrement: true,
primaryKey: true,
type: DataTypes.INTEGER
},
name: {
type: DataTypes.STRING(20),
allowNull: false
},
age: {
type: DataTypes.SMALLINT,
allowNull: false
},
//错误示例：此字段不在 “user” 表中，填写在这会出现ts报错，有效避免bug
// test: {
// type: DataTypes.SMALLINT,
// allowNull: false
// }
})
//配置数据表other
localhost_test.createModel('ohter', {
test: {
type: DataTypes.STRING(20),
allowNull: false
}
})· 导出实例
配置好后导出即可，在api中就可以直接使用了
export default localhost_test2.使用
// 在要使用的文件中导入
import localhost_test from "../localhost_test";
// ......
// 下面是使用示例
const res = localhost_test.test(); //测试是否链接正常
const res = JSON.stringify(localhost_test.modelMap.user); //测试获取模型
const res = await localhost_test.add("user", { name: "小蓝", age: 18} );//添加数据
const res = await localhost_test.findAll("user", { attributes: ["name"] }); //查询所有数据，并且只返回name字段
const res = await localhost_test.findAll("user", { where: { id: { [Op.gt]: 5 } } }); //查询所有数据，只返回id > 5 的字段
const res = await localhost_test.update("user", { name: "666" }, { where: { name: "小红" } }); //把所有名字为小红的名字改成666
const res = await localhost_test.delete("user", { where: { name: "小明" } }); //删除所有名字叫小明的数据
const res = await localhost_test.findByPage('user', 1, 10)//分页查询，第一页的10个数据
const res = await localhost_test.randomFind('user', 10),//从表中随机获取10个数据四、结语
更多关于sequelize的使用，可以查看官方文档 Sequelize 简介 | Sequelize中文文档 | Sequelize中文网
Sequelize | Feature-rich ORM for modern TypeScript & JavaScript