记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex

此文章是我自己用来记录如何搭建一个以express为基础的api服务器框架的过程,并不是什么新手教程,并不会每一步都写得非常详细,如果您要阅读此文,需要一点nodejs和编写代码的基础知识

文接上篇 链接: 地址 https://blog.csdn.net/goodboy31985/article/details/106260004
在上文基础上,修改和完善api服务器的框架

nodejs操作SQL数据库,Sequelize和Knex

  • 安装mysql数据库的npm包
  • 直接使用sql语句操作数据库
  • Knex使用
  • 通过浏览器查询用户信息
  • Sequelize使用

安装mysql数据库的npm包

要在本机安装mysql数据库,推荐使用docker,具体内容可以参考之前的文章
链接: link https://blog.csdn.net/goodboy31985/article/details/106204527

无论你选择是否使用Sequelize或者Knex等其他更方便的工具,为了让nodejs能够操作mysql,需要安装mysql包,直接使用npm安装即可
npm install --save mysql2
安装完成后,我们就已经可以再nodejs中连接并操作数据库了

直接使用sql语句操作数据库

我们先在数据库中创建一个新的数据库test 并新建一张表 palyer,里面填写一些数据
记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第1张图片
字段包括 id name age phone
并且有2条数据

在项目中新建一个DBManager的文件,创建一个数据库管理类,来管理数据库的操作
记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第2张图片
DBManager.ts文件内容

// lib/common/DBManager.ts

import mysql2 from "mysql2"

export class DBManager
{
    //单例
    private static instance: DBManager = null;
    private constructor()
    {

    }
    public static GetInstance()
    {
        if (DBManager.instance == null)
        {
            DBManager.instance = new DBManager();
        }
        return DBManager.instance;
    }


    //mysql数据库对象
    sqldb = null;

    //连接数据库,参数中填写数据库地址,端口等信息
    InitMysql()
    {
        this.sqldb = mysql2.createConnection({
            host: 'localhost',
            user: 'root',
            password: '123456',
            port: '3306',
            database: 'test'
        });
    }
}

在start.ts中写一些测试代码,测试是否能够查询成功

async function main()
{
    //日志增强功能初始化
    LogHelper.Init();

    console.log("app start");

    //ApiServer.GetInstance().Init();
    //await ApiServer.GetInstance().Run();

    //mysql测试
    DBManager.GetInstance().InitMysql()
    DBManager.GetInstance().sqldb.connect();//连接数据库
    DBManager.GetInstance().sqldb.query("SELECT * FROM player", (error, results, fields) =>
    {
        //如果查询出现错误
        if (error) {
            console.error(error);
            DBManager.GetInstance().sqldb.end();//关闭连接
        }

        //打印查询的结果
        console.log(results);
        DBManager.GetInstance().sqldb.end();//关闭连接
    });
}

main();

我们直接运行一下代码
记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第3张图片
我们已经可以查询到数据库中相关的内容
这里我们直接使用SQL查询语句
记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第4张图片
当要执行比较复杂的数据库操作时,直接使用SQL语句显然是比较麻烦的,通常在项目中也很少会这样直接使用,下面就介绍两个比较常用的库,来简化我们的SQL操作

Knex使用

Knex是一款query builder(查询构建器),让我们可以使用nodejs风格的语句来进行SQL操作,很大程度上避免了直接使用SQL语句
直接使用npm进行安装
npm install --save knex
npm install --save mysql2 //knex的功能同样依赖于nodejs的mysql库,如果你在前面已经安装过,这步就可以跳过

修改DBManager.ts文件,引入knex,并使用knex建立连接

// lib/common/DBManager.ts

import knex from "knex"

export class DBManager
{
    //单例
    private static instance: DBManager = null;
    private constructor()
    {

    }
    public static GetInstance()
    {
        if (DBManager.instance == null)
        {
            DBManager.instance = new DBManager();
        }
        return DBManager.instance;
    }

    //mysql数据库对象
    sqldb = null;

    //连接数据库,参数中填写数据库地址,端口等信息
    InitMysql()
    {
        this.sqldb = knex({
            client: 'mysql2',//指明数据库类型,还可以是pg,sqlite3等等
            connection: {  //指明连接参数
                host: 'localhost',
                user: 'root',
                password: '123456',
                port: 3306,
                database: 'test'
            },
            debug: true, //指明是否开启debug模式,默认为true表示开启
            pool: { //指明数据库连接池的大小,默认为{min: 2, max: 10}
                min: 2,
                max: 10,
            },
            acquireConnectionTimeout: 10000, //指明连接计时器超时,默认为60000ms
        });
    }
}

export const db=DBManager.GetInstance()//直接导出一个db 代码写起来方便一点

使用了Knex之后,我们基本可以不用考虑查询后连接的关闭问题,它默认是帮我们启用连接池的
这里我们修改一下start.ts中的查询语句

async function main()
{
    //日志增强功能初始化
    LogHelper.Init();

    console.log("app start");

    //ApiServer.GetInstance().Init();
    //await ApiServer.GetInstance().Run();

    //mysql测试
    db.InitMysql()
    let result = await db.sqldb.select().from("player");
    console.log(result);
    console.log(result[0]);
    console.log(result[0].name);

    result = await db.sqldb.select("name").from("player").where("id", ">", 1)
    console.log(result);

    
}

main();

记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第5张图片
代码中执行了2次查询,2个红框分别是2次查询的结果
并且可以直接使用 async 和 await 这样的特性,方便我们写异步代码,脱离回调地狱

通过浏览器查询用户信息

接下来,我们重新调整一下代码,使用浏览器向服务器发送请求,查询用户信息
使用 api/users/:id 这个路径,通过向服务器发送id,获取用户信息
修改start.ts

//start.ts
import fs from "fs"
import json5 from "json5";
import path from 'path'
import { ApiServer } from "./ApiServer/ApiServer";
import { LogHelper } from "./lib/common/LogHelper";
import { DBManager, db } from "./lib/common/DBManager";

//项目根目录
export const rootDir = __dirname + "/";

//加载配置文件
//读取json5文件内容
let jsonFile = fs.readFileSync(path.join(rootDir, "config.json5")).toString();
//解析为json文件,并作为模块输出
export let config = json5.parse(jsonFile);


async function main()
{
    //日志增强功能初始化
    LogHelper.Init();

    console.log("app start");

    //数据库连接初始化
    db.InitMysql();

    ApiServer.GetInstance().Init();
    await ApiServer.GetInstance().Run();

}

main();

修改UserController.ts

// Controller/UserController.ts

import { Request, Response, NextFunction } from 'express'
import { db } from '../lib/common/DBManager';

export class UserController
{
    // GET users/:id
    static async UserInfo(req: Request, res: Response,next:NextFunction)
    {
        let user = req.params;
        console.log("receive a GET request");
        console.log('[', req.method, '][', req.originalUrl, ']');
        console.log(req.params);

        let userinfo=await db.sqldb.select().from("player").where("id", "=", req.params.id);
        
        return res.json(userinfo).end();
    }
}

启动服务器,并且通过浏览器查询用户信息
记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第6张图片
记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第7张图片

Sequelize使用

knex还是比较偏向底层的,方便我们构造出响应的sql语句
通常还会使用ORM框架,来操作数据库
关系型数据库每张表有不同的字段,
| id | name | birth |
| 1 | Gaffey | 2007-07-07 |
| 2 | Odie | 2008-08-08 |
每一行数据就可以对应到一个js对象

{
    "id": 1,
    "name": "Gaffey",
    "birth": "2007-07-07"
}

这就是传说中的ORM技术:Object-Relational Mapping,把关系数据库的表结构映射到对象上。
我们选择Node的ORM框架Sequelize来操作数据库。这样,我们读写的都是JavaScript对象,Sequelize帮我们把对象变成数据库中的行。

  • 数据库中设计一个user表,来记录用户信息
    记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第8张图片
    表中设计以上的字段,用来定义一个用户
  • 定义user的模型(Model)
    Sequelize通过定义模型,把数据库表中的字段和js对象形成对应的关系
    在src下建立Model文件夹,用来存放所有的Model文件,然后新建一个UserModel.ts文件,建立Users的模型
    记录nodejs使用express搭建一个api服务器程序(5)-nodejs操作SQL数据库,Sequelize和Knex_第9张图片
    通过npm命令 安装sequelize,同时 还需要安装相应数据库的包比如 mysql
    npm install --save sequelize
    npm install --save mysql2 //功能同样依赖于nodejs的mysql库,如果你在前面已经安装过,这步就可以跳过

UserModel.ts文件内容

// Model/UserModel.ts
import { Sequelize, Model, DataTypes, BuildOptions } from 'sequelize';
import { HasManyGetAssociationsMixin, HasManyAddAssociationMixin, HasManyHasAssociationMixin, Association, HasManyCountAssociationsMixin, HasManyCreateAssociationMixin } from 'sequelize';
import { db } from '../lib/common/DBManager.sequelize';

//下面的UserModel.init代码需要用到一个sequelize的实例,这里的实例是从DBManager获取的,详解DBManager.sequelize.ts文件
db.InitMysql();
let sequelize = db.sequelize;

export class UserModel extends Model
{
    public id!: number;// 注意在严格模式下需要 `null assertion` 或 `!`. 
    public email!: string;
    public password!: string;
    public phone!: string | null;//可以为空的字段
    public username!: string|null;
    public nickname!: string|null;
    public age!: number|null;
}

UserModel.init(
    {
        id: {
            type: DataTypes.BIGINT({length:10}).UNSIGNED,
            autoIncrement: true,
            primaryKey:true,
        },
        email: {
            type: DataTypes.STRING(100),
            allowNull:false,
        },
        password: {
            type:  DataTypes.STRING(32),
            allowNull:false,
        },
        phone: {
            type:  DataTypes.STRING(15),
            allowNull: true,
        },
        username: {
            type:  DataTypes.STRING(30),
            allowNull: true,
        },
        nickname: {
            type:  DataTypes.STRING(30),
            allowNull: true,
        },
        age: {
            type:  DataTypes.INTEGER({length:3}),
            allowNull: true,
        }
    },
    {

        // 将自动设置所有属性的字段参数为下划线命名方式.
        // 不会覆盖已经定义的字段选项
        underscored: true,

        // 不添加时间戳属性 (updatedAt, createdAt)
        timestamps: false,
        // 不删除数据库条目,但将新添加的属性deletedAt设置为当前日期(删除完成时). 
        // paranoid 只有在启用时间戳时才能工作
        paranoid: false,
        // 禁用修改表名; 默认情况下,sequelize将自动将所有传递的模型名称(define的第一个参数)转换为复数. 如果你不想这样,请设置以下内容
        freezeTableName: true,
        // 定义表的名称
        tableName: "users",
        sequelize,
    }
)

创建一个DBManager.sequelize.ts文件,用来作为sequelize的管理,为了区别前一部分Knex的内容,我们把原来Knex的管理改名为 DBManager.knex.ts
DBManager.sequelize.ts文件内容

// lib/common/DBManager.sequelize.ts

import { Sequelize } from 'sequelize';
import { config } from '../../start';

export class DBManager
{
    //单例
    private static instance: DBManager = null;
    private constructor()
    {

    }
    public static GetInstance()
    {
        if (DBManager.instance == null)
        {
            DBManager.instance = new DBManager();

        }
        return DBManager.instance;
    }

    //连接数据库,参数中填写数据库地址,端口等信息
    sequelize: Sequelize = null;
    

    InitMysql()
    {
        if (this.sequelize != null)
        {
            console.log("already inited");
            return;
        }
        this.sequelize = new Sequelize(
            config.database.dbname,
            config.database.user,
            config.database.password,
            {
                host: config.database.server,
                dialect: "mysql",
                pool: {
                    min: 0,
                    max: 10,
                    idle: 30000,
                },
                // disable logging; default: console.log
                logging: false
            }
        )
    }
}

export const db = DBManager.GetInstance()//直接导出一个db 代码写起来方便一点

修改start.ts 文件,做一些简单的测试
start.ts

//start.ts
import fs from "fs"
import json5 from "json5";
import path from 'path'


//项目根目录
export const rootDir = __dirname + "/";
//加载配置文件
//读取json5文件内容
let jsonFile = fs.readFileSync(path.join(rootDir, "config.json5")).toString();
//解析为json文件,并作为模块输出
export let config: ConfigInterface = json5.parse(jsonFile);


import { ApiServer } from "./ApiServer/ApiServer";
import { LogHelper } from "./lib/common/LogHelper";
//import { db } from "./lib/common/DBManager.knex";
import { cache } from "./lib/common/CacheManager";
import { ConfigInterface } from "./Interface/ConfigInterface"

import { db } from "./lib/common/DBManager.sequelize";
import {UserModel} from "./Model/UserModel"

import md5 from "md5"


async function main()
{
    //日志增强功能初始化
    LogHelper.Init();

    console.info("app start");

    //数据库连接初始化
    try
    {
        db.InitMysql()//初始化sequelize对象
        await db.sequelize.authenticate();//进行数据库测试连接
        console.info('MySQL Connection has been established successfully.');//如果连接成功就打印信息
    } catch (err) {
        console.error('Unable to connect to the database:', err);
    }
    
    //进行数据库同步,如果发现数据库中没有这张表,会自动按照Model设置的字段创建数据表,如果已经有表格了,就不做改变
	await UserModel.sync();

	//尝试创建一个新用户
    let newUser = await UserModel.create({
        email: "[email protected]",
        password: md5("123456"),//密码保存为MD5形式
    })
    console.log(newUser);

	//查询表格
    let users = await UserModel.findAll();
    console.log(users[0].email);

    ApiServer.GetInstance().Init();
    await ApiServer.GetInstance().Run();

}

main();

运行后数据库中就会多出一张users表格,并且我们在里面插入了一行数据
在这里插入图片描述
一次最简单的Sequelize数据库操作遍完成了

使用Sequelize可以将数据表映射为对象,操作起来比单纯写SQL语句要方便得多,并且可以自动创建数据表,十分方便

你可能感兴趣的:(nodejs)