Express中间件(非常详细)

下面是对Express框架中间件的处理,希望可以帮助到有需要的小伙伴~

中间件

什么是中间件

中间件就是一堆方法,

可以接收客户端发来的请求

可以对请求做出响应

也可以将请求继续交给下一个中间件继续处理。

Express中间件(非常详细)_第1张图片

中间件主要由两部分构成,中间件方法以及请求处理函数
中间件方法由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('网站服务器启动成功');

中间件应用

  1. 路由保护,客户端在访问需要登录的页面时,可以先使用中间件判断用户登录状态

    • 如果用户未登录,则拦截请求,直接相应,禁止用户进入需要登录的页面
    • 如果用户登录了,则不拦截请求,允许用户进入需要登录的页面
    // 引入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('网站服务器启动成功');
    
    
  2. 网站维护公告,在所有路由的最上面定义接收所有请求的中间件,直接为客户端做出响应,网站正在维护中。

    // 引入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('网站服务器启动成功');
    
    
  3. 自定义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('网站服务器启动成功');
    
    

Express中间件(非常详细)_第2张图片

错误处理中间件

在程序执行的过程中,不可避免的会出现一些无法预料的错误,比如文件读取失败,数据库连接失败。

错误处理中间件是一个集中处理错误的地方。

注意:

错误处理中间件只能处理同步错误,不能处理异步错误,如果要处理异步错误,需要使用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中间件(非常详细)_第3张图片

异步错误实例:

// 引入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('网站服务器启动成功');

Express中间件(非常详细)_第4张图片

end~

你可能感兴趣的:(Express)