为什么要用nodemon

在编写调试node.js项目的时候,如果修改了项目的代码,则需要频繁的手动close掉,然后再重新启动,非常繁琐。

现在,我们可以使用nodemon 这个工具 它能够监听项目文件的变动,当代码被修改后,nodemon会自动帮我们重启项目,极大的方便了开发和调试。

安装 nodemon
在终端中,运行如下命令,即可将nodemon安装为全局可用的包

npm install -g nodemon

使用nodemon

当基于nodejs编辑了一个网站的应用的时候 运行node app.js命令就可以启动项目
现在 我们可以把node替换为nodemon 来启动项目 这样代码被修改之后会自动重启项目

nodemon app.js

路由的概念

1 什么是路由

广义来讲,路由就是映射关系。

2 现实生活中的路由
人工客服的不同按键对应业务:按键与服务之间的映射关系

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

Express中的路由由三个部分组成,分别是请求的类型 请求的url地址 处理函数 格式如下:

app.METHOD(PATH,HANDLER)

METHOD可以是get post…请求类型

PATH是客户端请求的具体url地址

HANDLER代表服务端的处理函数

4 express中路由的例子

//匹配GET请求 且请求URL为 /

app.get('/',function(req,res){
	res.send('Hello World!')
})
//匹配post请求 且请求URL为 /
app.post('/',function(req,res){
	res.send('Got a post request')
	
})

5 路由的匹配过程

每当客户端发起一个请求后,这个请求都会先经过路由的匹配,只有匹配成功后,才会调用对应的处理函数。

在匹配时,会按照路由的顺序进行匹配,如果请求类型和请求URL同时匹配成功,则Express会将这次请求,转交给对应的function函数进行处理。

注意:
按照定义的先后顺序进行匹配
请求类型和请求的URL同时匹配成功,才会调用对应的处理函数

路由的使用

最简单的方法:
在Express中使用路由最简单的方式,就是把路由挂载到app上,实例代码:

const express = require("express")

//创建服务器
const app = express()

//挂载路由
app.get('/',(req,res)=>{
})

app.post('/',(req,res)=>{
})

//启动服务器
app.listen(80,()=>{})

2 模块化的路由
为了方便对路由进行模块化的管理,EXpress不建议将路由直接挂载到app上,而是推荐将路由抽离为单独的模块

直接挂载到app上代码会太多 不利于管理

将路由抽离为单独模块的步骤如下:
1 创建路由模块对应的js文件
2 调用express.Router()函数创建路由对象

3 向路由对象上挂载具体的路由
4 使用module.exports向外共享路由对象
5 使用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('')

//使用app.use()注册路由模块
app.use(userRouter)

在这里插入图片描述

注意:app.use()函数的作用就是用来注册全局中间件

  • 为路由模块添加前缀,类似于托管静态资源时

路由模块添加前缀的方式也很简单:

//导入模块
const userRouter = require('')

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

Express中间件

什么是中间件
中间件一般都有输入与输出 指的就是业务处理过程中的中间处理环节

中间件的调用流程

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

在这里插入图片描述

Express中间件的格式

Express的中间件,本质上就是一个function处理函数,Express中间件的格式如下:

app.get('/',function(req,res,next){
	next()
})

注意:中间件函数的形参列表中,必须包含next参数,而路由处理函数中只包含req和res

next函数的作用

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

当中间件处理完成后会使用next函数来转交给下一个中间件来处理 最终通过路由来最终处理

Express中间件的初体验

1 定义中间件函数
可以通过如下方式,定义一个最简单的中间件函数:

//常量 a 所指向的,就是一个中间件函数
const a = function (req, res, next) {
    console.log('这是一个最简单的中间件函数')
    //注意:在当前中间件的业务处理完毕后,必须调用next()函数
    //表示把流转关系交给下一个中间件或路由

    next()
}

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

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

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

3 定义全局中间件的简化形式

可以将定义函数加上注册中间件函数一块写

//全局生效的中间件
app.use(function(req,res,next){
	console.log('xxx')
	next()
})

4 中间件的作用

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

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

app.use(function (req, res, next) {
    //第一个全局中间件
    console.log('说明了第一个全局中间件')
    next()
})

app.use(function (req, res, next) {
    //第二个全局中间件
    console.log('调用了第二个全局中间件')
    next()
})

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

6 局部生效的中间件

不使用app.use()定义的中间件,叫做局部生效的中间件,实例代码如下:

//定义中间件函数 mw1
const mw1 = function (req, res, next) {
    console.log('这是中间件函数')
    next()
}

//mw1这个中间件只在“当前路由中生效” 这种用法属于“局部生效的中间件”
app.get('/', mw1, function (req, res) {
    res.send('Home Page')
})

//mw1 这个中间件不会影响下面这个路由
app.get('/123', function (req, res) {
    res.send('123 Page')
})

7 定义多个局部的中间件
在路由中 通过如下两种等价方式 使用多个局部中间件

//以下两种写法是完全等价的方式,使用多个局部中间件
app.get('/',mw1,mw2,(req,res)=>{})
app.get('/',[mw1,mw2],(req,res)=>{})

8 了解中间件的五个使用注意shixiang

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

中间件的分类

为了方便大家理解和记忆中间件的使用 Express官方把常见的中间件用法,分成了五大类:

1 应用级别的中间件
2 路由级别的中间件
3 错误级别的中间件
4 express 内置的中间件
5 第三方的中间件

应用级别的中间件

通过app.use()或app.get()或app.post(),绑定到app实例上的中间件,叫做应用级别的中间件

app.get('/', mw1, function (req, res) {
    res.send('Home Page')
})

路由级别的中间件

绑定到express.Router()实例上的中间件,叫做路由级别的中间件。它的用法和应用级别中间件没有任何区别,只不过,应用级别中间件是绑定到app实例上,路由级别中间件绑定到router实例上

var app = express()
var router = express.Router()

//路由级别中间件
router.use(function(req,res,next){
	next()
})

app.use('/',router)

错误级别的中间件

错误级别中间件的作用:专门用来捕获整个项目中发生的异常错误,从而防止项目异常崩溃的问题。

格式:错误级别中间件的function处理函数中,必须要有4个行参,形参顺序从前到后,分别是(err,req,res,next).

app.get('/',function(req,res){
	throw new Error('服务器内部发生了错误')
	res.send('xxx')
	})

app.use(function(err,req,res,next){
	console.log('发生了错误' + err.message)
	res.send(Error!+err.message)
	
})
const express = require('express')
const app = express()

app.get('/', (req, res) => {

    //人为的制造错误
    throw new Error('服务器内部发生了错误')
    res.send('Home Page')
})


//定义错误级别的中间件 捕获整个项目的异常错误 从而防止程序的崩溃
app.use((err, req, res, next) => {
    console.log("错误" + err.message)
    res.send('出错了' + err.message)
})

app.listen(80, () => {
    console.log('服务在80端口启动了')
})

Express 内置的中间件

自Express4.16.0版本开始 Express内置了3个常用的中间件 极大的提高了Express项目的开发效率和体验:

1 express.static :能够快速的托管静态资源的内置中间件 例如 HTML文件 图片 CSS样式等
2 express.json解析JSON格式的请求体数据(有兼容性 )
3 express.urlencoded解析URL-encoded格式的请求体数据

//配置解析 application/json 格式数据的内置中间件
app.use(express.json())

//配置解析application/url-encoded格式数据的内置中间件
app.use(express.urlencoded({extended:false}))
//导入express模块
const express = require('express')

//创建实例
const app = express()

//注意出了错误级别的中间件,其他的中间件 必须在路由之前进行配置
//通过express.json() 这个中间件 解析表单中的JSON格式的数据
app.use(express.json())

app.post('/user', (req, res) => {
    //在服务器,可以使用req.body 这个属性,来接收客户端发过来的请求体数据
    //默认情况下如果不配置解析表单数据的中间件 则req.body默认等于undefined
    console.log(req.body)
    res.send('ok')
})

//调用app.listen方法,指定端口号并启动web服务器

app.listen(80, () => {
    console.log('服务器在80端口启动了')
})

注意:除了错误级别的中间件,其他的中间件 必须在路由之前进行配置

在服务端 可以通过 req.body来获取JSON格式的表单数据和url-encoded 格式的数据

第三方的中间件

非express官方内置的 而是由第三方开发出来的中间件,叫做第三方中间件,在项目中,大家可以按需下载并配置 第三方中间件,从而提高项目的开发效率

例如:在express@4.16.0 之前版本中,经常使用body-parser 这个第三方中间件 来解析请求体数据,使用步骤如下:

1 运行npm install body-parser 安装中间件
2 使用require导入中间件
3 调用app.use()方法注册并使用中间件

注意:Express内置的express.urllencoded中间件,就是基于body-parser 这个第三方中间件进一步封装出来的。

自定义中间件

1 需求描述与实现步骤
自己手动模拟一个类似于express.urlencoded这样的中间件,来解析POST提交到服务器的表单数据。

实现步骤:
定义中间件
监听req的data事件
监听req的end事件
使用quertstring模块解析请求数据
将解析出来的数据对象挂载到req.body
将自定义中间件封装

2 定义中间件
使用app.use()来定义全局生效的中间件:
app.use(function(req,res,next)(
//中间件的业务逻辑
})

3 监听req对象的data事件
在中间件中,需要监听req对象的data事件,来获取客户端发送到服务器的数据。

如果数据量比较大,无法一次性发送完毕,则客户端会把数据切割后,分批发送到服务器。所有data事件可能会触发多次,每一次触发data事件时,获取到的数据只是完整数据的一部分,需要手动对接收到的数据进行拼接。

//定义变量 用来储存客户端发送过来的请求体数据
let str= ''

//监听req对象的data事件 (客户端发过来新的请求体数据)
req.on('data',(chunk)=>{
	//拼接请求体数据,隐式转化为字符串
	str +=chunk
})

4 监听req的end事件

当请求体数据接收完毕之后,会自动触发req的end事件
因此,我们可以在req的end事件中,拿到并处理完整的请求体数据。

//监听req对象的end事件
req.on('end',()=>{
//打印完整的请求体数据
	console.log(str)
	//ToDO: 把字符串格式的请求体数据,解析成对象格式
	
})

5 使用querystring模块解析请求体数据
Node.js内置了一个querystring模块,专门用来处理查询字符串,通过这个模块提供的parse()函数,可以轻松把查询字符串,解析成对象的格式。

//导入处理querystring的nodejs内置模块
const qs = require('querystring')

//调用qs.parse()方法,把查询字符串解析为对象
const body = qs.parse(str)

6 将解析出来的数据对象挂载为req.body
上游的中间件和下游的中间件及路由之间,共享同一份req和res,因此,我们可以将解析出来的数据,挂载为req的自定义属性,命名为req.body,供下游使用。

      const body = qs.parse(str)
		//将解析出来的请求体对象,挂载为req.body属性
        req.body = body  
        next()          
        //最后一定要调用next()函数,执行后续业务逻辑    

7 将自定义中间件封装为模块

为了优化代码结构 我们可以把自定义的中间件函数,封装为独立的模块

const qs = require('querystring')
function bodyParser(req,res,next){

}
module.exports = bodyParser  //向外导出解析请求体的中间件函数




//导入模块
const myBodyParser = require('上面的文件名')

//注册自定义的中间件模块
app.use(myBodyParser)
  • 最终源码
const express = require('express')
const app = express()

//导入自定义中间件模块
const customBodyParser = require('./自定义中间件')


//将自定义的中间件函数注册为全局可用的中间件函数
app.use(customBodyParser)

app.post('/user', (req, res) => {
    res.send(req.body)
})


app.listen(80, () => {
    console.log('服务运行在了80端口')
})

//导入处理querystring的nodejs内置模块
const qs = require('querystring')


const bodyParse = (req, res, next) => {
    //定义中间件具体的业务逻辑
    //定义一个str字符串专门用来存储客户端发送过来的请求数据
    let str = ''
    //监听req的data事件
    req.on('data', (chunk) => {
        str += chunk
    })

    //监听req对象的end事件
    req.on('end', () => {
        //打印完整的请求体数据
        console.log(str)
        //ToDO: 把字符串格式的请求体数据,解析成对象格式

        //调用qs.parse()方法,把查询字符串解析为对象
        const body = qs.parse(str)

        req.body = body  //调用qs.parse()方法 把查询字符串解析为对象
        next()          //将解析出来的请求体对象,挂载为req.body属性
        //最后一定要调用next()函数,执行后续业务逻辑               
    })
}

module.exports(bodyParser)
Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐