express笔记
这里不再提及express的定义或者作用等。
1.安装
使用npm install express (--save)
进行安装
2.基本使用
1)开启服务器
const express= require('express');const app = express();app.listen(3000);
2)接收get请求
send()方法:
send方法内部会检测响应内容的类型send方法会自动设置http状态码send方法会帮我们自动设置响应的内容类型及编码
app.get('/',(req,res)=>{res.send('hello,express!')})//send方法也可以直接传递一个对象:app.get('/',(req,res)=>{res.send({name:'Jack',age:20})})
3.中间件
1)什么是中间件
中间件就是一堆方法,可以接收客户端发来的请求,可以对请求做出响应,也可以将请求继续交给下一个中间件继续处理。
中间件主要由两部分构成:中间件方法和请求处理函数。
中间件方法由Express提供,负责拦截请求,请求处理函数由开发人员提供,负责处理请求。
2)中间件处理请求
可以针对同一个请求设置多个中间件,对同一个请求进行多次处理。
默认情况下,请求从上到下依次匹配中间件,一旦匹配成功,终止匹配。
可以调用next方法将请求的控制权交给下一个中间件,直到遇到结束请求的中间件:
app.get('/request',(req,res,next)=>{req.name='Jack';next(); //使用next继续向下执行})app.get('/request',(req,res)=>{res.send(req.name); //传回req.name,值是上一个中间件设置的})
3)app.use中间件用法
app.use
匹配所有的请求方式,可以直接传入请求处理函数,代表接收所有的请求。
app.use((req,res,next)=>{console.log(req.url);next();})
app.use
第一个参数也可以传入请求地址,代表不论什么请求方式,只要是这个请求地址就接收这个请求。
app.use('/admin',(req,res,next)=>{console.log(req.url);next();})
4)中间件的应用
路由保护。客户端在访问需要登录的页面时,可以先使用中间判断用户登录状态,用户如果未登录,则拦截请求,直接响应,禁止用户进入需要登录的页面。
app.use('/admin',(req,res,next)=>{let isLogin=false; if(isLogin) //如果登录状态正确,执行下一个请求next();elseres.send('您还没有登录,不能访问该页面')})app.get('/admin',(req,res)=>{res.send('您已登录,可以访问当前页面')})
网站维护公告。在所有路由的最上面定义接收所有请求的中间件,直接为客户端做出响应:网站正在维护中。
//网站公告app.use((req,res,next)=>{res.send('当前网站正在维护...')})//因为没有next(),后续所有请求不会执行
自定义404页面。
app.use((req,res,next)=>{//为客户端响应404状态码以及提示信息res.status(404).send('当前访问的页面不存在')})
5)错误处理中间件
在程序执行的过程中,不可避免地会出现一些无法预料的错误,比如文件读取失败,数据库链接失败。
错误处理中间件是一个集中处理错误的地方。
简单的例子:
app.get('/index',(req,res)=>{throw new Error('程序发生未知错误');//这里抛出一个错误})//错误处理中间件app.use((err,req,res,next)=>{res.status(500).send(err.message);//err对象接收错误,message属性即抛出错误的信息})
读取文件错误的例子:
const fs=require('fs');app.get('/index',(req,res,next)=>{fs.readFile('./demo.txt','utf8',(err,res)=>{if(err)next(err) //传入err参数,如果出错执行错误处理中间件else res.send(res)})})//错误处理中间件app.use((err,req,res,next)=>{res.status(500).send(err.message);})
6)捕获错误
node.js中,异步API的错误信息都是通过回调函数获取的,支持Promise对象的异步API发生错误可以通过catch方法捕获。
异步函数执行如果发生错误要如何捕获呢?
try catch
可以捕获异步函数以及其他同步代码在执行过程中发生的错误,但是不能捕获其他类型的API发生的错误。
app.get('/',async(req,res,next)=>{//使用async定义异步函数try{await User.find({name:'Jack'})} catch(ex){next(ex);}})
4. 构建模块化路由
1)基础代码
const express =require('express')//创建服务器const app =express();//创建路由对象const home = express.Router();//将路由和请求路径进行匹配app.use('/home',home);//在home路由下继续创建路由(二级路由)home.get('/index',()=>{// home/indexres.send('hello')})//此时二级路由可以响应 /home/index
2)多模块
home.js
const home = express.Router();home.get('/index',()=>{res.send('这是展示页面')});module.exports = home;
admin.js
const admin = express.Router();admin.get('/index',()=>{res.send('这是管理页面')});module.exports = admin;
app.js
const home = require('./route/home.js');const admin = require('./route/admin.js');app.use('/home',home);app.use('/admin',admin);
5.express请求处理
1)GET参数的获取
Express框架中使用req.query
即可获取GET参数,框架内部会将GET参数转化为对象并返回。
//接收地址栏中问号后面的参数//例如: http://localhost:3000/?name=Jack&age=20app.get('/',(req,res)=>{console.log(req.query);//-> {"name":"Jack","age":"20"}})
2)POST参数的获取
Express中接收post请求参数需要第三方包 body-parser。
//引入body-parser模块const bodyParser = require('body-parser');//配置body-parse模块app.use(bodyParser.urlencoded({extended:false }));//extended:false 方法内部使用querystring模块处理请求参数的格式//extended:true 方法内部使用第三方模块qs处理请求参数的格式//接收请求app.post('/add',(req,res)=>{//接收参数console.log(req.body);})
3)Express路由参数
//在请求的路径上使用 :id 表示接收一个参数,是一个对象,对象名为idapp.get('/find/:id',(req,res)=>{console.log(req.params); })//访问localhost/find/123//-> {id:123}//使用多个参数:app.get('/find/:id/:name/:age',(req,res)=>{});
4)静态资源处理
通过Express内置的express.static
可以方便地托管静态文件,例如img,css,JavaScript文件等。
app.use(express.static('public'))
则此时就可以访问public文件夹下的各种文件。
express-art-template模板引擎
为了使art-template模板引擎能够更好和express框架配合,模板引擎官方在原有模板引擎的基础上封装了 express-art-template。
使用npm install art-template express-art-template
命令进行安装。
//1.告诉express框架使用什么模板引擎渲染什么后缀的模板文件//当渲染后缀为art的模板时,使用express-art-templateapp.engine('art',require('express-art-template'));//2.设置模板存放目录app.set('views',path.join(_dirname,'views'));//3.告诉express框架模板的默认后缀是什么//渲染模板时不写后缀,默认拼接art后缀app.set('view engine','art');app.get('/',(req,res)=>{//渲染模板res.render('index',{msg:'message'});})/* 这里做了四件事情:1. 拼接模板路径2. 拼接模板后缀3. 哪一个模板和哪一个数据进行了拼接4. 将拼接结果响应给客户端*/
index.art文件
{{ msg }}