为什么要用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)
推荐阅读
发表评论