Express路由
路由的概念
现实生活中的 路由:例如我们在拨打10086的时候,会让我们按指定的按键选择对应的服务,这里的路由就是按键和服务之间的映射关系。
- Express中的路由
在Express中,路由指的是客户端的请求与服务器处理函数之间的映射关系。
Express中的路由分三部分组成,分别是请求的类型、请求的URL地址、处理函数,格式如下:
app.METHOD(PATH, HANDLER)
例子:
//匹配GET请求,这里的get就是请求的类型,且请求URL为/
app.get('/', function(req, res) {
res.send('Hello Word!')
})
//匹配POST请求,且请求URL为/
app.post('/', function(req, res) {
res.send('Got a POST request!')
})
- 路由的匹配过程
每当 一个请求到达服务器之后,需要先经过路由的匹配,只有匹配成功之后,才会调用对应的处理函数。
在匹配时,会按照路由的顺序进行匹配,如果请求类型和请求URL同时匹配成功,则Express会将这次请求转交给对应的function函数进行处理。
注意点:按照定义的先后顺序进行匹配
请求的URL类型和请求的URL同时匹配成功,才会调用对应的处理函数。
路由的使用
- 最简单的用法
在Express中使用路由最简单的方式就是把路由挂载到app上,但这种不常用,因为挂载路由过多,文件体积太大,示例代码如下:
const express = require('express')
//创建web服务器命名为app
const app = express()
//挂载路由
app.get('/', (req, res) => { res.send('Hello World.') })
app.post('/', (req, res) => { res.send('Post request.') })
//启动web服务器
app.listen(80, () => {console.log('server running at http://127.0.0.1') })
如下是get请求
- 模块化路由
为了方便对路由进行模块化管理,Express不建议将路由直接挂载到app上,而是推荐将路由抽离为单独的模块。将路由抽离为单独模块的步骤如下:- 创建路由模块对应的.js文件
- 调用express.Router()函数创建路由对象
- 向路由 对象上挂载具体的路由
- 使用 module.exports向外共享路由对象
- 使用app.use()函数注册路由模块
- 创建路由模块
var express = require('express') //导入express
var router = express.Router() //创建路由对象
router.get('/user/list', function (req, res) { //挂载获取用户列表的路由
res.send('Get user list.')
})
router.post('/user/add', function (req, res) { //挂载添加用户的路由
res.send('Add new user.')
})
module.exports = router //向外导出路由对象
- 注册路由模块
//导入路由 模块
const userRouter = require('./router/user.js')
//使用app.use()注册路由模块
app.use(userRouter)
注:app.use()方法简单介绍,后面有章节会详细介绍该方法,这里只是简单了解
app.use() 是 Express 框架中用于添加中间件
的一个方法。它可以用于为指定的路径添加中间件功能,当请求的路径与定义的路由相匹配时,相应的中间件就会被执行。
- 以下是 app.use() 的具体用法:
- 基本用法:app.use(path, callback),其中 path 是一个字符串、数组或正则表达式,用于定义中间件应用的路径;callback 是当请求匹配到该路径时执行的函数或路由处理对象。
- 中间件链:可以在一个应用中连续使用多个 app.use(),形成一个中间件链。请求会依次经过这些中间件,每个中间件可以处理特定的任务,如解析请求体、验证用户身份等。
- 全局中间件:如果不提供路径,app.use() 添加的中间件将被视为全局中间件,适用于所有路由。
- 内置中间件:Express 提供了一些内置的中间件函数,如 express.json() 用于解析 JSON 格式的请求体。
- 第三方中间件:也可以使用第三方中间件,如 body-parser、cors 等,通常使用 app.use() 来引入并使用这些中间件。
- 错误处理中间件:app.use() 还可以用于添加错误处理中间件,这类中间件需要接收四个参数(err, req, res, next),以便在发生错误时进行处理。
- 别名:app.use() 实际上不仅是 app.get(), app.post(), app.all() 等路由方法的底层实现,它们都可以看作是 app.use() 的别名,因为它们本质上都是在指定路径上添加中间件。
- 综上所述,app.use() 是 Express 中非常核心的一个概念,它允许开发者灵活地为 HTTP 请求添加各种处理逻辑,从而实现复杂的 Web 应用功能。在使用 app.use() 时,需要注意中间件的执行顺序和作用范围,以确保应用的正确性和安全性。
- 为路由模块添加前缀
类似于托管静态资源时,为静态资源统一挂载访问前缀一样,路由模块添加前缀的方式也很简单:
添加前:app.use(router)
添加后:app.use(‘/api’, router)
添加后这个路由模块的每个路由在访问的时候前面都需要加上该前缀 - 模块化路由示例
首先我们在目录下有这样的两个js文件,里面有相应的代码,然后运行服务器
打开相应网址