Express 路由

Express 路由

在Express 中，路由指的是客户端的请求与服务器处理函数之间的映射关系。

Express 中的路由分3 部分组成，分别是请求的类型，请求的URL 地址，处理函数，

1 app.METHOD(PATH,HANDLER)

① 按照定义的先后顺序进行匹配。

② 请求类型和请求的URL 同时匹配成功，才会调用对应的处理函数。

1.最简单的用法 把路由挂载到app上

1 #安装
2 npm i express@4.17.1

const express = require('express');
const app = express();

//挂载路由
app.get('/', (req, res) => {
    res.send("hello")
})
app.post('/', (req, res) => {
    res.send("post request")
})

app.listen(80, () => {
    console.log('http://127.0.0.1');
})

2.模块化路由 创建路由模块

//05
//这是路由模块
// 1.导入express
const express = require('express');

//2.创建路由对象
const router = express.Router();

// 3.挂载获取用户列表的路由
router.get('/', (req, res) => {
        res.send("Get user list");
    })
    // 4.挂载添加用户的路由
router.post('/', (req, res) => {
        res.send("add new user")
    })
    //5.向外导出路由对象
module.exports = router;

3.注册路由模块

//04
// 导入路由模块
const router = require('./05.router')

//注册路由模块
app.use(router);
// app.use(express.static('./files'))  //之前的
// app.use() 函数的作用，就是来注册全局中间件的 router express.static('./files') 就是中间件

4 为路由模块添加前缀

// 导入路由模块
const userRouter = require('./05.router')

//使用app.use() 注册路由模块，并添加同意的访问前缀  /api
app.use('/api',userRouter);

3.3 Express 中间件

3.3.1 中间件概念

当一个请求到达 Express 的服务器之后，可以连续调用多个中间件，从而对这次请求进行预处理。

中间件函数必须有 next 函数，是实现多个中间件连续调用的关键，它表示把流转关系转交给下一个中间件或路由。

1.定义中间件函数

//定义最简单的中间件函数
const mw = function(res, req, next) {
    console.log('最简单的中间件函数');
    //把扭转关系，转交给下一个中间件或路由
    next();
}

2.全局生效的中间件

客户端发起的任何请求，到达服务器之后，都会触发的中间件，叫做全局生效的中间件。通过调用 app.use(中间件函数)，即可定义一个全局生效的中间件。

//全局生效的中间件
app.use(mw);

//点击send之后向服务器发送一个请求，服务器接收到了这个请求，在接收到请求之后，先把这个请求交给中间件来进行处理，
//中间件处理完之后，会调用next() 把扭转关系，转交给下一个中间件或路由，因为只注册了一个全局的中间件 所以没有额外的中间件被调用 于是把扭转关系，转交给了路由
app.get('/', (req, res) => {
    console.log("调用了 / 路由");
    res.send("home"); //向客户端响应
})

3.中间件的作用

多个中间件之间，共享同一份req 和res ，这样 在上游的中间件中，统一为req 和res 对象添加自定义的属性或方法，供下游的中间件或路由进行使用。

//定义最简单的中间件函数  简写
app.use((req, res, next) => {
    //获取到请求到达服务器的时间
    const time = Date.now();
    // 为req 对象，挂载自定义属性，从而把时间共享给后面的所以路由
    req.startTime = time;
    next();
})

app.get('/', (req, res) => {
    res.send("home" + req.startTime); //向客户端响应
})

4.定义多个中间件

可以使用app.use() 连续定义多个全局中间件，客户端请求到达服务器之后，会按照中间件定义的先后顺序依次进行调用。

// 调用第一个全局中间件
app.use((req, res, next) => {
        console.log("调用第1个全局中间件");
        next();
    })
    // 调用第二个全局中间件
app.use((req, res, next) => {
    console.log("调用第2个全局中间件");
    next();
})

app.get('/', (req, res) => {
    //请求这个路由，会依次触发上述两个全局中间件
    res.send("home");
})

5.局部生效的中间件

不使用app.use() 定义的中间件，叫做局部生效的中间件

//定义中间件函数
const mw = function(req, res, next) {
        console.log("这是中间件函数");
        next();
    }
    //mw 这个中间件只在/ "当前路由中生效"，这种用法属于"局部生效的中间件"
app.get('/', mw, (req, res) => {
    res.send("home"); //向客户端响应
})

// mw 这个中间件不会影响下面这个路由
app.get('/user', (req, res) => {
    res.send("home1"); //向客户端响应
})

6.定义多个局部中间件

1 //写法等价
2 app.get('/', mw1,mw2, (req, res) => {res.send("home");})
3 app.get('/', [mw1,mw2], (req, res) => {res.send("home");})

注意：

• 一定在路由之前注册中间件。
• 客户端发送过来的请求，可以连续调用多个中间件进行处理。
• 执行完中间件的业务代码之后，不要忘记调用 next() 函数。
• 为防止代码逻辑混乱，调用 next() 函数后不要再写额外的代码。
• 连续调用多个中间件时，多个中间件之间，共享req 和res 对象。

3.3.2 中间件的分类

1.应用级别的中间件

通过app.use() 或app.get() 或app.post()，绑定到app 实例上的中间件。

2.路由级别的中间件

绑定到express.Router() 实例上的中间件，路由级别的中间件绑定到router 实例上。

3.错误级别的中间件

作用：专门用来捕获整个项目中发生的异常错误，从而防止项目异常崩溃的问题。错误级别的中间件的function 处理函数中，必须有4个形参，形参顺序从前到后， (err,req,res,next) 。

1 app.get('/',function(req,res){               //路由
2    throw new Error('服务器内部发生了错误')      //抛出一个自定义的错误
3    res.send('home')
4    })
5 app.use(function(err,req,res,next){          //错误级别的中间件
6    console.log('发生了错误'+err.message)       //在服务器打印错误消息
7    res.send('Error'+err.message)              //向客户端响应错误相关的内容
8   })

4.Express内置的中间件

① express.static 快速托管静态资源的内置中间件。

② express.json 解析JSON 格式的请求体数据。

③ express.urlencoded 解析URL-encoded格式的请求体数据。

1 app.use(express.json())
2 app.use(express.urlencoded({extended:false}))

5.第三方中间件