数据库与身份认证
一、数据的基本概念
1. 什么是数据库
数据库(database)是用来组织、存储
和管理
数据的仓库.。
当今世界是一个充满着数据的互联网世界,充斥着大量的数据
。数据的来源
有很多,比如出行记录、消费记录、浏览器的网页、发送的消息等等。除了文本类型的数据,图像、音乐、声音都是数据。
为了方便管理互联网世界的数据,就有了数据库管理系统
的概念(简称:数据库)。用户可以对数据库中的数据进行新增、查询、更新、删除
等操作。
2. 常见的数据库及分类:
市面上的数据库有很多种,最常见的数据库有如下几个:
MySQL
数据库(目前使用最广泛、流行读最高
的开源免费数据库; Community + Enterprise)- Oracle数据库(收费)]
- SQL Server数据库(收费)
- Mongodb数据库(Community + Enterprise)
其中,MySQL、Oracle、SQL Server属于传统型数据库
(又叫做:关系型数据库
或SQL数据库
),这三者的设计理念相同,用法比较类似。
而Mongodb属于新型数据库(又叫做:非关系型数据库
或NoSQL数据库
),它在一定程度上弥补了传统型数据库的缺陷
3. 传统型数据库的数据组织结构
数据的组织结构:指的就是数据以什么样的结构进行存储。
传统型数据库的数据组织结构,与Excel中数据的组织结构比较类似
3.1 Excel的数据组织结构
每个Excel中,数据的组织结构分别为工作簿、工作表、数据行、列
这4大部分组成。
- 整个Excel叫做
工作簿
- users和books是
工作表
- users工作表总有3行数据
- 每行数据由6列信息组成
- 每列信息都有对应的
数据类型
3.2 传统型数据库的数据组织结构
在传统型数据库中,数据的组织结构分为数据库(database)、数据表(table)、数据行(row)、字段(field)
这4大部分组成
数据库类似于Excel的工作簿
数据表类似于Excel的工作表
数据行类似月Excel的每一行数据
字段类似于Excel的列
每个字段都有对应的数据类型
3.3 实际开发中库、表、行、字段的关系
- 在实际项目开发中,一般情况下,每个项目都对应
独立的数据库
。 - 不同的数据,要存储到数据库的不同表中,例如:用户数据存储到users表中,图书数据存储到books表中。
- 每个表中具体存储那些信息,有字段来决定,例如:我们可以为users表设计id、username、password这3个字段
- 表中的行,代表每一条具体的数据
二、安装并配置MySQL
1. 了解需要安装那些MySQL相关的软件
对于开发人员来说,只需要安装MySQL Server
和MySQL Workbench
这两个软件,就能满足开发的需要了。
- MySQL Server:
专门用来提供数据库存储和服务的软件
。 - MySQL Workbench:
可视化的MySQL管理工具
,通过他,可以方便的操作存储在MySQL Server中的数据
2. MySQL在Mac环境下的安装:
- 先运行
mysql-8.0.19-macos10.15-x86_64.dmg
这个安装包,将 MySQL Server 安装到 Mac 系统- 再运行
mysql-workbench-community-8.0.19-macos-x86_64.dmg
这个安装包,将可视化的 MySQL Workbench 工具安装到 Mac 系统
具体的安装教程,可以参考 素材 -> MySQL for Mac ->安装教程 - Mac系统安装MySql -> README.md
3. MySQL在Windows环境下的安装
在 Windows 环境下安装 MySQL,只需要运行 mysql-installer-community-8.0.19.0.msi
这个安装包,就能一次 性将 MySQL Server 和 MySQL Workbench 安装到自己的电脑上。
具体的安装教程,可以参考 素材 -> MySQL for Windows ->安装教程 - Windows系统安装MySql -> README.md
三、MySQL的基本使用
1. 使用MySQL Workbench管理数据库
2. 使用 SQL 管理数据库
2.1 什么是SQL
SQL(英文全称:Structured Query Language)是结构化查询语言
,专门用来访问和处理数据库
的编程语言。能够让我们以编程的形式,操作数据库里面的数据
三个关键点:
- SQL是一门
数据库编程语言
- 使用SQL语言编写出来的代码,叫做
SQL语句
- SQL语言
只能在关系型数据库中使用
(例如:MySQL、Oracle\SQL Server)。非关系型数据库(例如:Mongodb)不支持SQL语言
2.2 SQL能做什么
- 从数据库中
查询数据
- 向数据库中
插入新的数据
更新
数据库中的数据
- 从数据库
删除数据
- 可以创建新数据库
- 可在数据库中创建新表
- 可在数据库中创建存储过程、视图
- etc…
2.3 SQL的学习目标
重点掌握如何使用SQL从数据表中:
查询数据
(select)、插入数据
(insert into)、更新数据
(update)、删除数据
(delete)
额外需要掌握的4中SQL语法:
where条件、and和or运算符、order by 排序、count(*)函数
3. SQL的SELECT语句
3.1 语法
SELECT语句用于从表中查询数据
。执行的结果被存储在一个结果表
中(称为结果集
)。语法格式如下:
-- 这是注释
-- 从 FROM 指定的[表中],查询出[所有的]数据. * 表示[所有列]
SELECT * FROM 表名
-- 从 FROM 指定的[表中],查询出指定列名称(字段)的数据
SELECT 字段名 FROM 表名
注意:
SQL语句中的
关键字
对大小写不铭感
。SELECT等效于select,FROM等效于from
3.2 SELECT *
示例
我们希望从user表中选取所有的列,可以使用符号 *
取代列的名称,示例如下:
3.3 SELECT 列名称
示例
如需获取名为"userName
"和"userPwd
"的列的内容(从名为"user"的数据库表),请使用下面的SELECT 语句:
4. SQL的INSERT INTO 语句
4.1 语法
INSERT INTO
语句用于向数据表中插入新的数据行
,语法格式如下:
-- 语法解读:向指定的表中,插入如下几行数据,列的值通过 values 一一指定
-- 注意:列和值要一一对应,多个列和多个值之间,使用英文的逗号分隔
INSERT INTO 表名 (列1,列2...) VALUES (值1,值2...)
4.2 INSERT INTO
示例
向user表中,插入一条userName
为tony stark
,userPwd
为098123
的用户数据,示例如下;
5. SQL的 UPDATE语句
5.1 语法
UPDATE
语句用于修改表中的数据
。语法格式如下:
-- 语法解读;
-- 1. 用 UPDATE 指定要更新那个表中的数据
-- 2. 用 SET 指定列对应的新值
-- 3. 用WHERE 指定更新的条件
UPDATE 表名称 SET 列名称 = 新值 WHERE 列名称 = 某值
5.2 UPDATE 示例 - 更新某一行中的一个列
把 users表中 id 为 7 的用户密码,更新为 888888。示例如下
5.3 UPDATE 示例 - 更新某一行中的若干列
把 users 表中 id 为 2 的用户账号和用户密码,分别更新为 admin123
和 1234
。示例如下:
6. SQL的 DELETE语句
6.1 语法
DELETE语句用于删除表中的行,语法格式如下:
-- 语法解读:
-- 从指定的表中,根据'WHERE' 条件,删除对应的数据行
DELETE FROM 表名称 WHERE 字段 = 值
6.2 DELETE 示例
从 users表中,删除 id 为 4 的用户,示例如下:
7. SQL 的 WHERE 子句
7.1 WHERE子句用于限定选择的标准
。在SELECT 、UPDATE、DELETE
语句中,皆可使用
WHERE字句来限定选择的标准。
-- 查询语句中的WHERE条件
SELECT 字段名 FROM 表名 WHERE 列 运算符 值
-- 更新语句中的WHERE条件
UPDATE 表名 SET 字段 = 值 WHERE 列 运算符 值
-- 删除语句的WHERE条件
DELETE FROM 表名 WHERE 列 运算符 值
7.2 可在WHERE字句中使用的运算符
下面的运算符可在WHERE字句中使用,用来限定选择的标准:
操作符 | 描述 |
---|---|
= | 等于 |
<> | 不等于 |
> | 大于 |
< | 小于 |
>= | 大于等于 |
<= | 小于等于 |
BETWEEN | 在某个范围内 |
LIKE | 搜索某种模式 |
注意:在某些版本的SQL中,操作符<>可以写为 !=
7.3 WHERE字句示例
可以通过WHERE字句来限定SELECT 的查询条件:
-- 查询 status 为1的所有用户
SELECT * FROM users WHERE status = 1
-- 查询 id 大于 2 的所有用户
SELECT * FROM users WHERE id > 2
-- 查询 username 不等于 admin 的所有用户
SELECT * FROM users WHERE username <> admin
8. SQL的AND
和OR
运算符
8.1语法
AND和OR可在WHERE子语句
中把两个条件结合起来
。
AND表示必须同时满足多个条件
,相当于JavaScript中的&&运算符,例如if(a !== 10 && a !== 20)
OR表示只要满足任意一个条件即可
相当于JavaScript中的||运算符,例如if(a !==10 || a !== 20)
8.2 AND运算符示例
使用AND来显示所有 userName = admin,并且 userPwd = 123的用户:
8.3 OR运算符示例
使用OR来显示所有 userName = admin,或者 userPwd = 123的用户:
9. SQL的 ORDER BY 字句
9.1语法
ORDER BY 语句用于根据指定的列队结果集进行排序
ORDER BY 语句默认
按照升序
对记录进行排序
如果您学完按照降序
对记录进行排序,可以使用DESC
关键字
9.2 ORDER BY 字句 - 升序排序
对user表中的数据,按照id字段进行升序排序,示例如下:
9.3 ORDER BY 字句 - 降序排序
对user表中的数据,按照id字段进行降序排序,示例如下:
9.4 ORDER BY 子句 – 多重排序
对 users 表中的数据,先按照 status 字段进行降序排序,再按照 username 的字母顺序,进行升序排序,示例如下:
10. SQL的 COUNT(*)函数
10.1 语法
COUNT(*)
函数用于返回查询结果的总数据条数
,语法格式如下:
SELECT COUNT(*) FROM 表名
查询user表中userPwd密码相同的个数
10.2 使用AS
为列设置别名
如果希望给查询出啦的列名设置别名,可以使用AS 关键字,示例如下:
四、在项目中操作MySQL
1. 在项目中操作数据库的步骤
- 安装操作MySQL数据库的第三方模块(
msyql
)- 通过mysql模块
连接到MySQL数据库
- 通过mysql模块
执行SQL语句
2. 安装与配置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: 'qwe123', // 登陆数据库的密码
database: 'huawei' // 指定要操作那个数据库
})
2.3 测试mysql模块能否正常工作
调用db.query()函数,指定要执行的SQL语句,通过回调函数拿到执行的结果:
// 检测mysql模块能否正常工作
db.query('SELECT',(err,res) => {
if(err) return console.log(err.message)
// 只要能打印出[RowDataPacket{'1' : 1}] 的结果,就证明数据库连接正常
console.log(res)
})
2.4 查询数据
查询user表中的所有的数据:
// 查询user表中所有的数据
db.query('SELECT * FROM user',(err,results) => {
// 查询失败
if(err) return console.log(err.message)
// 查询成功
console.log(results)
})
2.5 插入数据
向 users 表中新增数据, 其中username
为 Spider-Man
,password
为 pcc321
。示例代码如下:
// 1. 要插入到users表中的数据对象
const user = {username:'Spider-Man',password:'pcc321'}
// 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.affectadRows === 1) {
console.log('插入数据成功!') // 成功
}
})
2.6 插入数据的便捷方式
向表中新增数据时,如果数据对象的每个属性
和数据表的字段一一对应
,则可以通过如下方式快速插入数据:
// 1. 要插入到users表中的数据对象
const user = {username: 'Spider-Man2',password: 'pcc321'}
// 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('插入数据成功')
}
})
2.7 更新数据
可以通过如下方式,更新表中的数据:
// 1. 要更新的数据对象
const user = {id:7,username: 'ldh',password:'123'}
// 2. 要执行的SQL语句
const sqlStr = 'UPDATE users SET username = ? ,password = ? WHERE id = ?'
// 3. 调用 db.query() 执行 SQL语句的同时,使用数组依次为占位符指定具体的值
db.query(sqlStr,[user.username,user.password,user.id],(err,results) => {
if(err) return console.log(err.messaeg)
if(results.affectedRows === 1) {
console.log('更新数据成功')
}
})
2.8 更新数据的便捷方式
更新表数据时,如果数据对象的每一个属性
和数据表的字段一一对应
,则可以通过如下快速更新表数据:
// 1.要更新的数据对象
const user = {id:7,username:'zs',password:'123'}
// 2. 要执行的SQL语句
const sqlStr = 'UPDATE users SET ? WHERE id = ?'
// 3. 调用db.query()执行SQL语句的同时,使用数组依次为占位符指定具体的值
db.query(sqlStr,[user,user.id],(err,results) => {
if(err) return console.log(err.message)
if(results.affectedRows === 1) {
console.log('更新数据成功')
}
})
2.9 删除数据
在删除数据时,推荐根据id这样的唯一标识,来删除对应的数据。示例如下:
// 1. 要执行的SQL语句
const sqlStr = 'DELETE FROM user WHERE id = ?'
// 2. 调用db.query()执行SQL语句的同时,为占位符指定具体的值
// 注意:如果SQL语句中有多个占位符,则必须使用数组为每个占位符指定具体的值
// 如果SQL语句中只有一个占位符,则可以省略数组
db.query(sqlStr,8,(err,results) => {
if(err) return console.log(err.message)
if(results.affectedRows === 1) {
console.log('删除数据成功!')
}
})
2.10 标记删除
使用DELETE语句,会把真正的把数据从表中删除掉。为了保险起见,推荐使用标记删除
的形式,来模拟删除的动作
。
所谓的标记删除,就是在表总设置类似于status
这样的状态字段
,来标记当前这条数据是否被删除
当用户执行了删除的动作时,我们并没有执行DELETE语句把数据删除掉,而是实行了UPDATE语句,将这条数据对应的status字段标记为删除即可
// 标记删除:使用 UPDATE语句替代DELETE语句;只更新数据的状态,并没有真正删除
db.query('UPDAET users SET status = 1 WHERE id = ?',6,(err,res) => {
if(err) return console.log(err.message)
if(res.affectedRows === 1){
console.log('删除数据成功!')
}
})
五、前后端的身份认证
1. Web开发模式
目前主流的Web开发模式有两种,分别是:
- 基于
服务端渲染
的传统Web开发模式- 基于
前后端分离
的新型Web开发模式
1.1 服务端渲染的Web开发模式
服务端渲染的概念
:服务器发送给客户端的HTML页面
,是在服务器通过字符串的拼接,动态生成的
。因此,客户端不需要使用Ajax这样的技术额外请求页面的数据,代码示例如下:
app.get('/index.html',(req,res) => {
// 1.要渲染的数据
const user = {name:'zs',age:20}
// 2. 服务器端通过字符串的拼接,动态生成HTML内容
const html = `<h1>姓名: ${user.name},年龄: ${user.age}</h1>`
// 3. 把生成好的页面内容响应给客户端,因此,客户端拿到的是带有真实数据的HTML页面
res.send(html)
})
1.2 服务端渲染的优缺点
优点:
前端耗时少
。因为服务器daunt负责动态生成HTML内容,浏览器只需要直接渲染页面即可。尤其是移动端,更省电。有利于SEO
。因为服务器端响应的是完整的HTML页面内容,所有爬虫更容易爬取获得信息,更有利于SEO。
缺点:
占用服务器端资源
。即服务器端完成HTML页面内容的拼接,如果请求较多,会对服务器造成一定的访问压力。不利于前后端分离,开发效率低
。使用服务器端渲染,则无法进行分工合作
,尤其对于前端复杂度高
的项目,不利于项目高效开发。
1.3 前后端分离
的Web开发模式
前后端分离的概念:前后端分离的开发模式,依赖于Ajax技术的广泛应用
。简而言之,前后端分离的Web开发模式。就是后端只负责提供API接口,前端使用Ajax调用接口
的开发模式。
1.4 前后端分离的优缺点:
优点:
开发体验好
。前端专注于UI页面的开发,后端专注于api的开发,且目前端有更多的选择性用户体验好
。Ajax技术的广泛应用,极大的提高了用户的体验,可以轻松实现页面的局部刷新。减轻了服务器端的渲染压力
。因为页面最终是在每个用户的浏览器中生效的。
缺点:
不利于SEO
。因为完整的HTML页面需要在客户端动态拼接完成,所有爬虫对无法爬取页面的有效信息。(解决方案:利于Vue、React等前端框架的SSR
(server side render)技术能够很好的解决SEO问题)
1.5 如何选择Web开发模式
不谈业务场景而盲目选择使用如何开发模式都是耍流氓。
- 比如企业级网站,主要功能是展示而没有复杂的交互,并且需要良好的SEO,则这时我们就需要使用服务器daunt渲染
- 二类似后台管理项目,交互性比较强,不需要考虑SEO,那么就可以使用前后端分离的开发模式。
另外,具体使用何种开发模式并不绝对的,为了同时兼顾
了首页的渲染速度
和前后端分离的开发效率
,一些网站采用了首屏服务器daunt渲染 + 其他页面前后端分离的开发模式
2. 身份认证
2.1 什么是身份认证
身份认证
(Authentication)又称"身份验证"、“鉴权”,是指通过一定的手段,完成对用户身份的确认
。
- 日常生活中的省份认证随处可见,例如:高铁的验票乘车,手机的密码或指纹解锁,支付宝或微信的支付密码等。
- 在Web开发中,也涉及到用户身份认证,例如:各大网站的
手机验证码登陆、邮箱密码登陆、二维码登陆
等
2.2 为什么需要身份认证
身份认证的目的,是为了确认当前所声称某种身份的用户,确实是所声称的用户
。例如,你去找快递员取快递,你要怎么证明这份快递是你的。
在互联网项目开发中,如何对用户的身份进行认证,是一个值得深入讨论的文件。例如,如何才能保证网站不会错误的将"马云的存款数额"显示到"马化腾的账户"上
2.3 不同开发模式下的身份认证
对于服务器渲染
和前后端分离
这两种开发模式来说,分别有着不同的身份认证方案:
服务端渲染
推荐使用Session认证机制
前后端分离
推荐使用JWT认证机制
3. Session认证机制
3.1 HTTP协议的无状态性
了解HTTP协议的无状态性是进一步学习Session认证机制的必要前提。
HTTP协议的无状态性,指的是客户端的每次HTTP请求都是独立的
,连续多个请求之间没有直接的关系,服务器不会主动保留每次HTTP请求的状态
.
3.2 如何突破
HTTP无状态的限制
对于超市来说,为了方便收银员在进行结算时给VIP用户打折,超市可以为每个VIP用户发放会员卡。
**注意:**现实生活中的会员卡身份认证方式
,在Web开发中的专业术语
叫做Cookie
。
3.3 什么是Cookie
Cookie是存储在用户浏览器中的一段不超过4kb的字符串
。它由一个名称(Name)
、一个值(Vaule)
和其他几个用于控制Cookie有限期、安全性、使用范围
的可选属性组成。
不同域名下的Cookie各自独立,每当客户端发起请求时,会自动
把当前域名下
所有未过期的Cookie
一同发送到服务器
Cookie的几大特性:
- 自动发送
- 域名独立
- 过期时限
- 4KB限制
3.4 Cookie在身份认证中的作用
客户端第一次请求服务器的时候,服务器通过响应头的形式
,行客户端发送一个身份认证的Cookie,客户端会自动将Cookie保存在浏览器中。
随后,当客户端浏览器每次请求服务器的时候,浏览器会自动
将身份认证相关的Cookie,通过请求头的形式
发送给服务器,服务器即可验明客户端的身份。
3.5 Cookie不具有
安全性
由于Cookie是存储在浏览器中的,而且浏览器也提供了读写Cookie的API
,因此Cookie很容易被伪造
,不具有安全性。因此不建议服务器将重要的隐私数据,通过Cookie的形式发送给浏览器。
注意:
千万不要使用Cookie存储重要且隐私的数据!比如用户的身份信息、密码等
3.6 提供身份认证的安全性
为了防止客户伪造会员卡,收营员在拿到客户出示的会员卡之后,可以在收银机上进行刷卡认证
。只有收银机确认存在的会员卡,才能被正常使用。
这种"会员卡" + "刷卡认证"
的设计理念,就是Session认证机制的精髓。
3.7 Session的工作原理
4. 在Express中使用Session认证
4.1 安装 express-session中间件
在Express项目中,只需要安装express-session中间件,即可在项目中使用Session认证:
npm install express-session
4.2 配置
express-session中间件
express-session中间件安装成功后,需要通过app.use()
来注册sesson中间件
,示例代码如下:
// 1. 导入 session中间件
let session = require('express-session')
// 2. 配置session中间件
app.use(session({
secret: 'keyboard cat', // secret属性的值可以为任意字符串
resave: false, // 固定写法,
savceUninitialized: true // 固定写法
}))
4.3 向 session中存数据
当express-session中间件配置成功后,即可通过req.session来访问和使用session对象,从而存储用户的关键信息:
app.post('/api/login',(req,res) => {
// 判断用户提交的登陆信息是否正确
if(req.body.username !== 'admin' || req.body.password !== '000000') {
return res.send({status : 1,msg : '登陆失败'})
}
req.session.user = req.body // 将用户的信息,存储到session中
req.session.islogin = true //将用户的登陆状态,存储到Session中
res.send({status: 0, msg: '登陆成功'})
})
4.4 向session中取数据
可以直接从 req.session对象上获取之前存储的数据,示例代码如下:
// 获取用户姓名的接口
app.get('/api/username',(req,res) => {
// 判断用户是否登陆
if(!req.session.islogin) {
return res.send({status: 1,mas: 'fail'})
}
res.send({status: 0, mas: 'success'},username: req.session.user.username)
})
4.5 清空session
调用req.session.destroy()函数,即可清空服务器保存的session信息
// 退出登陆的接口
app.post('/api/logout',(req,res) => {
// 清空当前客户端对应的session信息
req.session.destroy()
res.send({
status: 0,
msg:'退出登陆成功'
})
})
5. JWT认证机制
5.1 了解Session认证的局限性
Session认证机制需要配合Cookie才能实现
。由于Cookie默认不支持跨域访问,当涉及到前端跨域请求后端接口
的时候,需要做很多额外的配置
,才能实现跨域Session认证
注意:
- 当前端请求后端接口
不存在跨域问题
的时候,推荐使用Session
身份认证机制 - 当前端需要跨域请求后端接口的时候,不推荐使用Session身份认证机制,推荐使用JWT认证机制。
5.2 什么是JWT
JWT(英文全称:JSON Web Token)是目前最流行
的跨域认证解决方案
。
5.3 JWT的工作原理
5.4JWT的组成部分
JWT通常由三部分组成,分别是Header
(头部)、Payload
(有效荷载)、Signature
(签名)。
三者之间用英文"."分隔,格式如下:
Header.Payload.Signatuer
5.5 JWT的三个部分各自代表的含义
JWT的三个组成部分,从前到后分别是Header、Payload、Signature。
其中:
Payload
部分才是真正的用户信息
,它是用户信息经过加密之后生成的字符串- Header和Signature是
安全性相关
的部分,只是为了保证Token的安全性
5.6 JWT的使用方式
客户端收到服务器返回JWT之后,通常会将他存储在localStorage
或sessionStorage
中。
此后,客户端每次与服务器通信,都要带上这个JWT的字符串,从而进行身份认证。推荐的做法是把JWT放在HTTP请求头的Authorization字段中
,格式如下:
Authorization: Bearer <token>
6. 在Express中使用JWT
6.1 安装JWT相关的包
运行如下命令,安装如下两个JWT相关的包:
npm install jsonwebtoken exress-jwt
其中:
- jsonwebtoken用于生成JWT字符串
- express-jwt用于将JWT字符串解析还原成JSON对象
6.2 导入JWT相关的包
使用require()函数,分别导入JWT相关的两个包:
// 1. 导入用于生成JWT字符串的包
const jwt = require('jsonwebtoken')
// 2. 导入用于将客户端发送过来的JWT字符串,解析还原成JSON对象的包
const expressJWT = require('express-jwt')
6.3 定义secret秘钥
为了保证JWT字符串的安全性
,防止JWT字符串在网络传输过程中别人破解,我们需要专门定义一个用于加密和解密的secret秘钥:
- 当生成JWT字符串的时候,需要使用secret秘钥对用户的信息
进行加密
,最终得到加密好的JWT字符串- 当把JWT字符串串解析还原成JSON对象的时候,需要使用secret秘钥
进行解密
// 3. secret秘钥的本质:就是一个字符串
const secretKey = 'mcfeng No1 ^_^'
6.4 在登陆成功后生成JWT字符串
调用jsonwebtoken
包提供的sign()
方法,将用户信息加密成JWT字符串,响应给客户端:
// 登陆接口
app.post('/api/login',(req,res) => {
// ... 省略登陆失败情况下的代码
// 用户登陆成功之后,生成JWT字符串,通过token属性响应给客户端
res.send({
status: 200,
message: '登陆成功!',
// 调用 jwt.sign()生成JWT字符串,三个参数分别是:用户信息对象、加密密匙、配置对象
token: jwt.sign({username: userinfo.username},secretKey,{expiresIn: '30s'})
})
})
6.5 将JWT字符串还原为JSON对象
客户端每次在访问那些有权限接口的时候,都需要主动通过请求头中的Authorization字段,将Token字符串发送到服务器进行身份认证。
此时,服务器可以通过express-jwt这个中间件,自动将客户端发送过来的Token解析还原成JSON对象:
// 使用app.use() 来注册中间件
// express.JWT({secret: secretKey}) 就是用来解析Token的中间件
// .unless({path:[/^\/api\//]}) 用来指定那些接口不要需要访问权限
app.use(expressJWT({secret: secretKey}).unless({path:[/^\/api\//]}))
6.6 使用req.use获取用户信息
当express-jwt这个中间件配置成功之后,即可在那些有权限的接口中,使用req.use
对象,来访问从JWT字符串中解析出来的用户的用户信息了,示例代码如下:
// 这是一个有权限的API接口
app.get('/admin/getinfo',(req,res) => {
console.log(req.user)
res.send({
status: 200,
message: '获取用户信息成功!',
data: req.user
})
})
6.7 捕获解析JWT失败后产生的错误
当使用express-jwt解析Token字符串时,如果客户端发送过来的Token字符串过期
或不合法
,会产生一个解析失败的错误,影响项目的正常运行。我们可以通过Express的错误中间件
,捕获这个错误并进行相关的处理。示例代码如下:
app.use((err,req,res,next) => {
// token解析失败导致的错误
if(err.name === 'UnauthorizedError') {
return res.send({status: 401, message: '无效的token'})
}
// 其他原因导致的错误
res.send({status:500, message: '未知错误'})
})