Express框架特性
- 提供了方便简洁的路由定义方式
- 对获取http请求参数进行了简化处理
- 对模板引擎支持程度高,方便渲染动态HTML页面
- 提供了中间件机制有效控制HTTP请求
- 拥有大量第三方中间件对功能进行扩展
基本使用
// 引入express
const express = require("express");
// 创建网站服务器
const app = express();
app.get("/",(req,res) => {
// 1、send 方法内部会检测响应内容的类型
// 2、send 方法会自动设置http状态码
// 3、send 方法会帮我们自动设置响应的内容类型及编码
res.send("Hello Express!")
})
app.listen(3000,() => {
console.log("runing at http://localhost:3000")
})
中间件
概念
中间件就是一堆方法,可以接受客户端发来的请求、可以对请求做出响应,也可以将请求继续交给下一个中间件继续处理
中间件主要由两部分组成,中间件方法以及请求处理函数
中间件方法由Express提供,负责拦截请求,请求处理函数由开发人员提供,负责处理请求
app.get("路径",处理函数); // 接收并处理get请求
app.post("路径",处理函数); // 接收并处理post请求
可以针对同一个请求设置多个中间件,对同一个请求进行多次处理,默认情况下请求从上到下依次匹配中间件,一旦匹配成功,终止匹配。可以调用next方法将请求的控制权交给下一个中间件,直到遇到结束请求的中间件。
app.get("/request",(req,res.next) => {
req.name = "张三"
})
app.get("/request",(req,res) => {
res.send(req.name)
})
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();
})
中间件应用
1、路由保护,客户端再访问需要登录的页面时,可以先使用中间件判断用户登录状态,用户如果未登录,则拦截请求,直接响应,·q禁止用户进入需要登录的页面
2、网站维护公告,在所有路由的最上面定义接收所有请求的中间件,直接为客户端做出响应,网站正在维护中
3、自定义404页面
// 所有的中间件
app.get();
app.use((req,res,next) => {
// status 改变状态码
res.status(404).send("页面不存在")
});
错误处理中间件
在程序执行的过程中,不可避免的会出现一些无法预料的错误,比如文件读取失败,数据库连接失败,错误处理中间件是一个集中 处理错误的地方
app.use((err,req,res,next) => {
// err对象中有个message属性
res.status(500).send(err.message)
})
错误处理中间件只能主动捕获到同步代码抛出的错误,如果是异步代码,需要手东调用next(错误信息),此时错误中间件才可以捕获到错误
app.use("/admin",(req,res,next) => {
fs.readFile("./10.js",(err,data) => {
if(err){
next(err)
} else {
res.send(data);
}
})
})
捕获错误
在nodejs中,异步API的错误信息都是通过回调函数获取的,支持Promise对象的异步API发生错误可以通过catch方法捕获。
异步函数执行如果发生错误如何捕获呢?
try catch可以捕获异步函数以及其他同步代码在执行过程中发生的错误,但是不能捕获其他类型的API发生的错误。
app.get("/admin",async (req,res,next) => {
try {
await User.find({name:"张三"})
}catch(ex){
next(ex);
}
})
构建模块化路由
基础代码:
const express = require("express");
// 创建路由对象
const home = express.Router();
// 将路由和请求路径进行匹配
app.use("/home",home)
// 在home路由下继续创建路由
home.get("/index",(req,res,next) => {
// /home/index
res.send("ok")
})
构建模块化路由:
// home.js
const home = express.Router();
home.get("/index",(req,res) => {
res.send("ok")
});
module.exports = home
// admin.js
const admin = express.Router();
home.get("/index",(req,res) => {
res.send("ok")
});
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);
Get参数的获取
Express框架中使用req.query
即可获取GET参数,框架内部会将GET参数转换为对象并返回
// 接受地址栏中?后的参数
// 例如:http://localhost:3000/?name=zhangsan&age=30
app.get("/",(req,res) => {
console.log(req.query); // {"name":"zhangsan","age":"30"}
})
POST参数的获取
Express中接受post请求参数需要借助第三方包 body-parser
但是目前body-parser已被弃用,可以直接使用express.json()
和express.urlencoded({extended:false})
使用方法和body-parser一样
// 引入body-parser模块
const bodyParser = require("body-parser");
// 配置body-parser模块
// extended : false 方法内部使用querystring模块处理请求参数的格式
// extended: true 方法内部使用第三方模块qs处理请求参数的格式
app.use(bodyParser.urlencoded({extended:false}));
// 接收请求
app.post("/add",(req,res) => {
// 接收请求参数
console.log(req.body)
})
Express路由参数
app.get("/find/:id",(req,res) => {
console.log(req.params);// {id:123}
})
http://localhost:3000/find/123
静态资源的处理
通过内置的express.static()
可以方便的托管静态文件,例如img,css,js文件等
app.use(express.static("public"));
重定向
res.redirect("/admin/login")