Express中间件（非常详细）
下面是对Express框架中间件的处理，希望可以帮助到有需要的小伙伴~
中间件
什么是中间件
中间件就是一堆方法，
可以接收客户端发来的请求
可以对请求做出响应
也可以将请求继续交给下一个中间件继续处理。
中间件主要由两部分构成，中间件方法以及请求处理函数。
中间件方法由Express提供，负责拦截请求，请求处理函数由开发人员提供，负责处理请求。
app.get('请求路径','处理函数') // 接收并处理get请求
app.post('请求路径','处理函数') // 接收并处理post请求
可以针对同一个请求设置多个中间件，对同一个请求进行多次处理。
// 引入express框架
const { SSL_OP_NETSCAPE_CA_DN_BUG } = require('constants');
const express = require('express');
// 创建网站服务器
const app = express();
// 参数next是一个方法，有next就可以使用下一个中间件，否则一旦中间件匹配成功，就不会去找下一个中间件了
// 给req添加了一个name属性，name属性的属性值是‘张三’
app.get('/request',(req,res,next) => {
req.name = '张三';
next();
});
// 把name属性发送给客户端
app.get('/request',(req,res) => {
res.send(req.name);
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');
express().use中间件用法
注意：express().use中间件必须放在其他中间件的前面
- express().use 匹配所有的请求方式(即 任意一个地址都可以)，可以直接传入请求处理函数，代表接收所有的请求。
express().use((req,res,next) => {
console.log(req.url);
next();
})
- app.use 第一个参数也可以传入地址，代表不论什么请求方式，只要是这个请求地址就接收这个请求。
express().use('/admin',(req,res,next) => {
console.log(req.url);
next();
})
实例：
// 引入express框架
const { SSL_OP_NETSCAPE_CA_DN_BUG } = require('constants');
const express = require('express');
// 创建网站服务器
const app = express();
app.use((req,res,next) => {
console.log("请求走了app.use中间件");
next();
})
// 当客户端访问/request请求的时候走当前中间件
app.use('/request',(req,res,next) => {
console.log("请求走了app.use /request中间件");
next();
})
// 参数next是一个方法，有next就可以使用下一个中间件，否则一旦中间件匹配成功，就不会去找下一个中间件了
// 给req添加了一个name属性，name属性的属性值是‘张三’
app.get('/request',(req,res,next) => {
req.name = '张三';
next
});
// 把name属性发送给客户端
app.get('/request',(req,res) => {
res.send(req.name);
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');
中间件应用
-
路由保护，客户端在访问需要登录的页面时，可以先使用中间件判断用户登录状态
- 如果用户未登录，则拦截请求，直接相应，禁止用户进入需要登录的页面
- 如果用户登录了，则不拦截请求，允许用户进入需要登录的页面
// 引入express框架 const express = require('express'); // 创建网站服务器 const app = express(); // 定义一个中间件 app.use('/admin',(req,res,next) => { // 用户没有登录 let isLogin = false; // 如果用户登录 if (isLogin) { // 让请求继续向下执行 next() }else { // 如果没有用户登录 直接对客户做出响应 res.send('您还没有登录 不能访问/admin这个页面') } }) // 定义一个路由 app.get('/admin',(req,res) => { res.send('您已经登录 可以访问当前页面') }) // 监听端口 app.listen(3000); console.log('网站服务器启动成功'); -
网站维护公告，在所有路由的最上面定义接收所有请求的中间件，直接为客户端做出响应，网站正在维护中。
// 引入express框架 const express = require('express'); // 创建网站服务器 const app = express(); // 定义中间件 // 维护网站 app.use((req,res,next) => { res.send('当前网站正在维护...') }) // 保护路由 app.use('/admin',(req,res,next) => { // 用户没有登录 let isLogin = false; // 如果用户登录 if (isLogin) { // 让请求继续向下执行 next() }else { // 如果没有用户登录 直接对客户做出响应 res.send('您还没有登录 不能访问/admin这个页面') } }) // 定义一个路由 app.get('/admin',(req,res) => { res.send('您已经登录 可以访问当前页面') }) // 监听端口 app.listen(3000); console.log('网站服务器启动成功'); -
自定义404页面 （在代码中要放到最后写）
// 引入express框架 const express = require('express'); // 创建网站服务器 const app = express(); // 定义中间件 // 维护网站 /* app.use((req,res,next) => { res.send('当前网站正在维护...') }) */ // 保护路由 app.use('/admin',(req,res,next) => { // 用户没有登录 let isLogin = false; // 如果用户登录 if (isLogin) { // 让请求继续向下执行 next() }else { // 如果没有用户登录 直接对客户做出响应 res.send('您还没有登录 不能访问/admin这个页面') } }) // 定义一个路由 app.get('/admin',(req,res) => { res.send('您已经登录 可以访问当前页面') }) // 当所有请求都没有响应的时候，会返回“访问失败” app.use((req,res,next) => { // 修改状态码 /* res.status(404); res.send('当前访问的页面不存在'); */ // 等价于 res.status(404).send('当前访问的页面是不存在的') }) // 监听端口 app.listen(3000); console.log('网站服务器启动成功');
错误处理中间件
在程序执行的过程中，不可避免的会出现一些无法预料的错误，比如文件读取失败，数据库连接失败。
错误处理中间件是一个集中处理错误的地方。
注意：
错误处理中间件只能处理同步错误，不能处理异步错误，如果要处理异步错误，需要使用next()方法，并给next()方法传递参数
同步错误实例：
// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();
app.get('/index',(req,res) => {
// 手动抛出一个错误
throw new Error('程序发生了未知错误')
// res.send('程序正常执行')
})
// 错误处理中间件
app.use((err,req,res,next) => {
res.status(500).send(err.message);
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');
异步错误实例：
// 引入express框架
const express = require('express');
// 引入文件模块
const fs = require('fs');
// 创建网站服务器
const app = express();
app.get('/index',(req,res,next) => {
// 手动抛出一个错误
// throw new Error('程序发生了未知错误')
fs.readFile('./demo.txt','utf8',(err,result) => {
if (err != null) {
next(err)
} else {
res.end(result)
}
})
})
// 错误处理中间件
app.use((err,req,res,next) => {
res.status(500).send(err.message);
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');
错误处理中间件和其他中间件的区别：
-
错误处理中间件有4个参数 err req res next
-
err默认只能获取到同步代码执行时的错误；如果要获取异步代码执行的错误，需要添加next()方法，并传递参数
捕获错误
在nodejs中，异步API的错误信息都是通过回调函数获取的，支持Promise对象的异步API发生错误可以通过catch方法捕获。
try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误，但是不能捕获其他类型的API发生的错误。
实例：
// 引入express框架
const express = require('express');
// 引入文件模块
const fs = require('fs');
// 把读取文件的输出结果改为promise类型
const promisify = require('util').promisify;
const readFile = promisify(fs.readFile);
// 创建网站服务器
const app = express();
// 如果获取到错误，就执行catch里面的代码
// 如果没有捕获到错误，就执行catch后面的代码
app.get('/index',async(req,res,next) => {
try {
await readFile('./aaa.js')
} catch (err) {
next(err);
}
})
// 错误处理中间件
app.use((err,req,res,next) => {
res.status(500).send(err.message);
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');
end~