JavaScript全解析——Express框架介绍与入门
本文为千锋资深前端教学老师带来的【JavaScript全解析】系列，文章内含丰富的代码案例及配图，从0到1讲解JavaScript相关知识点，致力于教会每一个人学会JS！
文末有本文重点总结，可以收藏慢慢看~ 更多技术类内容，主页关注一波！
目录
express 的基本使用
express 是什么?
express是一个node的第三方开发框架
把启动服务器包括操作的一系列内容进行的完整的封装，不过在使用之前, 需要下载第三方
指令: npm install express
1.基本搭建
// 0. 下载: npm install express
// 0. 导入
const express = express();
// 1. 创建服务器
const server = express();
// 2. 给服务器配置监听端口号
server.listen(8080, () => {
console.log("服务器启动成功");
});
2.配置静态资源
之前约定:
1.所有静态资源以 /static 开头
2.按照后面给出的文件名自己去组装的路径
组装:
1.准备了初始目录 './client/'
2.按照后缀去添加二级目录
3.按照文件名去查找内容
例子: /static/index.html
1.自动去 './client/views/index.html'
b.现在:
i.约定:
1.所有静态资源以 /static 开头
2.按照 /static 后面的路径去访问指定文件
3.要求: 在 /static 以后的内容需要按照 二级路径的正确方式书写
a. 假设你需要请求的是 './client/views/index.html' 文件
b.你的请求地址需要书写 '/static/views/index.html'
c.语法:
i. express.static('开放的静态目录地址')
ii.server.use('访问这个地址的时候', 去到开放的静态目录地址)
// 0. 下载: npm install express
// 0. 导入
// 1. 创建服务器
// 1.1 配置静态资源
server.use("/static", express.static("./client/"));
// 2. 给服务器配置监听端口号
3.配置接口服务器
// 0. 下载: npm install express
// 0. 导入
// 1. 创建服务器
// 1.1 配置静态资源
// 1.2 配置服务器接口
server.get("/goods/list", (req, res) => {
/**
* req(request): 本次请求的相关信息
* res(response): 本次响应的相关信息
*
* req.query: 对 GET 请求体请求参数的解析
* 如果有参数, req.query 就是 {a:xxx, b:yyy}
* 如果没有参数, req.query 就是 {}
*/
console.log(req.query);
// res.end(JSON.stringify({code: 1, msg: '成功'}))
res.send({ code: 1, msg: "成功" });
});
server.post("/users/login", (req, res) => {
console.log(req.query);
// 注意! express 不会自动解析 post 请求的 请求体
res.send({
code: 1,
msg: "接收 POST 请求成功, 但是还没有解析请求体, 参数暂时不能带回",
});
});
// 2. 给服务器配置监听端口号
express 的路由
express 提供了一个方法能够让我们制作一张 "路由表"
目的就是为了帮助我们简化 服务器index.js 内部的代码量
服务器根目录/router/goods.js
// 专门存放于 goods 相关的路由表
const express = require("express");
// 创建一个路由表
const Router = express.Router();
// 向表上添加内容, 添加内容的语法, 向服务上添加的语法一样
Router.get("/info", (req, res) => {
res.send({
code: 1,
message: "您请求 /goods/list 成功",
});
});
// 导出当前路由表
module.exports.goodsRouter = Router
服务器根目录 /router/index.js
// 专门存放于 goods 相关的路由表
const express = require("express");
// 创建一个路由表
const Router = express.Router();
// 向表上添加内容, 添加内容的语法, 向服务上添加的语法一样
Router.get("/info", (req, res) => {
res.send({
code: 1,
message: "您请求 /goods/list 成功",
});
});
// 导出当前路由表
module.exports.goodsRouter = Router
服务器根目录 /index.js
// 0. 下载并导入 express
const express = require("express");
const router = require("./router"); // 相当于 ./router/index.js
// 1. 创建服务器
const server = express();
// 1.1 配置静态资源
server.use("/static", express.static("./client"));
// 1.2 配置接口
server.use("/api", router);
// 2. 给服务器监听端口号
server.listen(8080, () => {
console.log("服务启动成功, 端口号8080~~~");
});
express 的中间件
概念
○在任意两个环节之间添加的一个环节, 就叫做中间件
分类
全局中间件
■语法: server.use(以什么开头, 函数)
●server: 创建的服务器, 一个变量而已
●以什么开头: 可以不写, 写的话需要是字符串
●函数: 你这个中间件需要做什么事
// 0. 下载并导入第三方模块
const express = require("express");
// 0. 引入路由总表
const router = require("./router");
// 0. 引入内置的 fs 模块
const fs = require("fs");
// 1. 开启服务器
const app = express();
// 1.1 开启静态资源
app.use("/static", express.static("./client/"));
// 1.2 添加一个 中间件, 让所有请求进来的时候, 记录一下时间与请求地址
app.use(function (req, res, next) {
fs.appendFile("./index.txt", `${new Date()} --- ${req.url} \n`, () => {});
next(); // 运行完毕后, 去到下一个中间件
});
// 1.3 开启路由表
app.use("/api", router);
// 2. 给服务添加监听
app.listen(8080, () => console.log("服务器开启成功, 端口号8080~"));
路由级中间件
■语法: router.use(以什么开头, 函数)
●router: 创建的路由表, 一个变量而已
●以什么开头: 可以不写, 写的话需要是字符串
●函数: 你这个中间件需要做什么事
// 路由分表
const router = require("express").Router();
// 导入 cart 中间件
const cartMidd = require("../middleware/cart");
// 添加路由级中间件
router.use(function (req, res, next) {
/**
* 1. 验证 token 存在并且没有过期才可以
* 规定: 请求头内必须有 authorization 字段携带 token 信息
*/
const token = req.headers.authorization;
if (!token) {
res.send({
code: 0,
msg: "没有 token, 不能进行 该操作",
});
}
next();
});
router.get("/list", cartMidd.cartlist, (req, res) => {
res.send({
code: 1,
msg: "请求 /cart/list 接口成功",
});
});
router.get("/add", (req, res) => {
res.send({
code: 1,
msg: "请求 /cart/add 接口成功",
});
});
module.exports.cartRouter = router;
请求级中间件
■直接在请求路由上, 在路由处理函数之前书写函数即可
// 路由分表
const router = require("express").Router();
// 导入 cart 中间件
const cartMidd = require("../middleware/cart");
router.get("/list", cartMidd.cartlist, (req, res) => {
res.send({
code: 1,
msg: "请求 /cart/list 接口成功",
});
});
router.get("/add", (req, res) => {
res.send({
code: 1,
msg: "请求 /cart/add 接口成功",
});
});
module.exports.cartRouter = router;
// ../middleware/cart.js
const cartlist = (req, res, next) => {
// 1. 判断参数是否传递
const { current, pagesize } = req.query;
if (!current || !pagesize) {
res.send({
code: 0,
msg: "参数current或者参数pagesize没有传递",
});
return;
}
if (isNaN(current) || isNaN(pagesize)) {
res.send({
code: 0,
msg: "参数current或者参数pagesize 不是 数字类型的, 请处理",
});
return;
}
next();
};
module.exports.cartlist = cartlist
错误中间件
■本质上就是一个全局中间件, 只不过处理的内容
// 0. 下载并导入第三方模块
const express = require("express");
// 0. 引入路由总表
const router = require("./router");
// 0. 引入内置的 fs 模块
const fs = require("fs");
// 1. 开启服务器
const app = express();
// 1.1 开启静态资源
app.use("/static", express.static("./client/"));
// 1.2 开启路由表
app.use("/api", router);
// 1.3 注册全局错误中间件(必须接收四个参数)
app.use(function (err, req, res, next) {
if (err === 2) {
res.send({
code: 0,
msg: "参数current或者参数pagesize没有传递",
});
} else if (err === 3) {
res.send({
code: 0,
msg: "参数current或者参数pagesize 不是 数字类型的, 请处理",
});
} else if (err === 4) {
res.send({
code: 0,
msg: "没有 token, 不能进行 该操作",
});
}
});
// 2. 给服务添加监听
app.listen(8080, () => console.log("服务器开启成功, 端口号8080~"));
/*
* 4. 错误中间件
* 为了统一进行错误处理
*
* 例子:
* 接口参数少
* 请求 /goods/list 参数少
* 请求 /cart/list 参数少
* 请求 /news/list 参数少
* res.send({code: 0, msg: '参数数量不对'})
* 接口参数格式不对
* 请求 /users/login 格式不对
* 请求 /goods/list 格式不对
* res.send({code: 0, msg: '参数格式不对})
*
* 思考:
* 正确的时候, 直接返回结果给前端
* 只要出现了错误, 统一回到全局路径上
*
* 操作:
* 当你在任何一个环节的中间件内
* => 调用 next() 的时候, 表示的都是去到下一个环节
* => 调用 next(参数) 的时候, 表示去到的都是全局错误环节
* 参数:
* 参数的传递需要自己和自己约定一些暗号
* 2: 表示 接口参数少
* 3: 表示 接口参数格式不对
* 4: 表示没有token
* 5: XXXX....
*/
token 的使用
●token 的使用分为两步
○加密
■比如用户登陆成功后, 将一段信息加密生成一段 token, 然后返回给前端
○解密
■比如用户需要访问一些需要登陆后才能访问的接口, 就可以把登录时返回的token保存下来
■在访问这些接口时, 携带上token即可
■而我们接收到token后, 需要解密token, 验证是否为正确的 token 或者 过期的 token
1.加密
/**
* 使用一个 第三方包 jsonwebtoken
*/
const jwt = require("jsonwebtoken");
/**
* 1. 加密
* 语法: jwt.sign(你要存储的信息, '密钥', {配置信息})
*/
const info = { id: 1, nickname: "肠旺面" };
const token = jwt.sign(info, "XXX", { expiresIn: 60 });
// console.log(token);
/*
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
eyJpZCI6MSwibmlja25hbWUiOiLogqDml7rpnaLliqDnjKrohJoiLCJpYXQiOjE2NzAxNTYwMDgsImV4cCI6MTY3MDE1NjA2OH0.
12-87hSrMYmpwXRMuYAbf08G7RDSXM2rEI49jaK5wMw
*/
2.解密
jwt.verify(token, "XXX", (err, data) => {
if (err) return console.log(err); // JsonWebTokenError: invalid signature
console.log(data);
});