十一在项目中操作MySQL

Posted 2022-12-05 上善若水

一、在项目中操作数据库的步骤

1. 安装操作mysql数据库的第三方模块（mysql）
2. 通过MySQL模块连接到MySQL数据库
3. 通过MySQL模块执行SQL语句
   

二、安装与配置MySQL模块

2.1、安装MySQL模块

MySQL模块是托管于 npm 上的第三方模块。它提供了在 Node.js 项目中连接和操作MySQL数据库的能力。想要在项目中使用它，需要先运行如下命令，将MySQL安装为项目的依赖包：

npm install mysql

2.2、配置MySQL模块

在使用MySQL模块操作MySQL数据库之前，必须先对MySQL模块进行必要的配置，主要的配置步骤如下：

// 1. 导入 MySQL 模块
const mysql = require('mysql')
// 2. 建立与MySQL数据库的连接
const db = mysql.createPool(
    host: '127.0.0.1',  // 数据库的ip地址
    user: 'root',   // 登录数据库的账号
    password: 'root',   // 登录数据库的密码
    database: 'my_db_01' // 指定要操作哪个数据库
)

2.3、测试 MySQL 模块能否正常工作

调用 db.query() 函数，指定要执行的 SQL 语句，通过回调函数拿到执行的结果：

// 检测 mysql 模块能否正常工作
db.query('SELECT 1',(err, results) => 
    if (err) 
        return console.log(err.message)
    
    // 只要能打印出 [ RowDataPacket  '1' : 1 ] 的结果，就证明数据库连接正常
    console.log(results)
)

三、使用MySQL模块操作MySQL数据库

3.1、查询数据

查询 users 表中所有的数据

// 查询 users 表中所有的用户数据
db.query('SELECT * FROM users', (err, results) => 
    // 查询失败
    if (err) 
        return console.log(err.message)
    
    // 查询成功
    console.log(results)
)

3.2、插入数据

向 users 表中新增数据，其中 username 为zhangsan，password为123456。示例代码如下：

// 1. 要插入到 users 表中的数据对象
const user = username: 'zhangsan', password: '123456'
// 2. 待执行的 SQL 语句，其中英文的 ? 表示占位符
const sqlStr = 'INSERT INTO users (username, password) VALUES (?, ?)'
// 3. 使用数据的形式，依次为 ? 占位符指定具体的值
db.query(sqlStr, [user.username, user.password], (err, results) => 
    // 插入失败
    if (err)
        return console.log(err.message)
    
    // 插入成功
    if(results.affectedRows === 1)
        console.log('插入数据成功')
    
)

3.3、插入数据的便捷方式

向表中新增数据时，如果 数据对象的每个属性和数据表的字段一一对应，则可以通过如下方式快速插入数据：

// 1. 要插入到 users 表中的数据对象
const user = username: 'zhangsan', password: '123456'
// 2. 待执行的 SQL 语句，其中英文的 ? 表示占位符
const sqlStr = 'INSERT INTO users SET ?'
// 3. 直接将数据对象当作占位符的值
db.query(sqlStr, user, (err, results) => 
    // 插入失败
    if (err)
        return console.log(err.message)
    
    // 插入成功
    if(results.affectedRows === 1)
        console.log('插入数据成功')
    
)

3.4、更新数据

可以通过如下方式，更新表中的数据：

// 1. 要更新的数据对象
const user = id: 3, username: 'lisi', password: '654321'
// 2. 要执行的 SQL 语句
const sqlStr = 'UPDATE users SET username = ?, password = ? WHERE id = ?'
// 3. 调用 db.query() 执行 SQL 语句的同时，使用数组依次为占位符指定具体的值
db.query(sqlStr, user, (err, results) => 
    // 更新失败
    if (err)
        return console.log(err.message)
    
    // 更新成功
    if(results.affectedRows === 1)
        console.log('更新数据成功')
    
)

3.5、更新数据的便捷方式

更新表数据时，如果数据对象的每个属性和数据表的字段一一对象，则可以通过如下方式快速更新表数据：

// 1. 要更新的数据对象
const user = id: 3, username: 'lisi', password: '654321'
// 2. 要执行的 SQL 语句
const sqlStr = 'UPDATE users SET ? WHERE id = ?'
// 3. 调用 db.query() 执行 SQL 语句的同时，使用数组依次为占位符指定具体的值
db.query(sqlStr, user, (err, results) => 
    // 更新失败
    if (err)
        return console.log(err.message)
    
    // 更新成功
    if(results.affectedRows === 1)
        console.log('更新数据成功')
    
)

3.6、删除数据

在删除数据时，推荐根据 id 这样的唯一标识，来删除对应的数据。示例如下：

// 1. 要执行的 SQL 语句
const sqlStr = 'DELETE FROM users WHERE id = ?'
// 2. 调用 db.query() 执行 SQL 语句的同时，为占位符指定具体的值
// 注意：如果 SQL 语句中有多个占位符，则必须使用数组为每个占位符指定具体的值
//      如果 SQL 语句中只有一个占位符，则可以省略数组
db.query(sqlStr, 3, (err, results) => 
    // 删除失败
    if (err)
        return console.log(err.message)
    
    // 删除成功
    if(results.affectedRows === 1)
        console.log('删除数据成功')
    
)

3.7、标记删除

使用 DELETE 语句，会把真正的把数据从表中删除掉。为了保险起见，推荐使用标记删除的形式，来模拟删除的动作。
所谓的标记删除，就是在表中设置类似于 status 这样的状态字段，来标记当前这条数据是否被删除。
当用户执行了删除的动作时，我们并没有执行 DELETE 语句把数据删除掉，而是执行了 UPDATE 语句，将这条数据对应的 status 字段标记为删除即可。

// 标记删除：使用 UPDATE 语句替代 DELETE 语句；只更新数据的状态，并没有真正删除
db.query('UPDATE users SET status = 1 WHERE id = ?', 3, (err, results) => 
    // 删除失败
    if (err)
        return console.log(err.message)
    
    // 删除成功
    if(results.affectedRows === 1)
        console.log('删除数据成功')
    
)