文章目录
Express是什么?
Express是基于Node平台的web应用开发框架,帮助创建各种web应用
Express特性
- 提供了方便简洁的路由定义方式
- 对获取HTTP请求参数进行了简化处理
- 对模板引擎支持程度高,方便渲染动态HTML页面
- 提供了中间件机制有效控制HTTP请求
- 拥有大量第三方中间件对功能进行扩展
基本使用语法
- 注意:send方法只可使用一次,不可重复使用
// 引入express框架
const express = require('express')
// 用框架创建web服务器
const app = express()
// 用户以get方式访问/index路由
app.get('/index', (req, res) => {
// 向客户端响应
// 1.send方法内部会检测响应内容类型
// 2.send方法会自动设置htpp状态码
// 3.send方法会自动设置响应内容类型以及编码
// res.send('hello express')
// res.send('你好!')
// res.send(12) 如果响应一个数字,它被当成状态码,会报错
// res.send('<h1>hello express</h1>')
// data = [2, 3, 4, 65]
data = {name:'zhangsan',age:18}
res.send(data)
})
// 监听端口
app.listen(3000)
中间件
什么是中间件
中间件就是一堆方法,可以接收客户端发来的请求、可以对请求做出响应,也可以将请求继续交给下一个中间件继续处理。
可以针对同一个请求设置多个中间件,对同一个请求进行多次处理。
默认情况下,请求从上到下依次匹配中间件,一旦匹配成功,终止匹配。
可以调用next方法将请求的控制权交给下一个中间件,直到遇到结束请求的中间件。
// 引入express框架
const express = require('express')
// 用框架创建web服务器
const app = express()
// 用户以get方式访问/index路由
app.get('/index', (req, res,next) => {
// 向客户端响应
req.name = '张三'
next() //继续往下进行中间件的匹配
})
app.get('/index', (req,res) => {
req.age = 20
res.send(req.name+','+req.age)
})
// 监听端口
app.listen(3000)
- 中间件主要由两部分构成,中间件方法以及请求处理函数
- 中间件方法由Express提供,负责拦截请求,请求处理函数由开发人员提供,负责处理请求
app.get('请求路径', '处理函数') // 接收并处理get请求
app.post('请求路径', '处理函数') // 接收并处理post请求
app.use中间件的使用
- app.use 匹配所有的请求方式,可以直接传入请求处理函数,代表接收所有的请求
app.use((req, res, next) => {
res.send('欢迎来到首页')
})
- app.use 第一个参数也可以传入请求地址,代表不论什么请求方式(相对路由中间件),只要是这个请求地址就接收这个请求。
app.use('/index', (req, res, next) => {
res.send('欢迎来到首页')
})
应用示例
- 路由保护,客户端在访问需要登录的页面时,可以先使用中间件判断用户登录状态,用户如果未登录,则拦截请求,直接响应,禁止用户进入需要登录的页面。
app.use('/index', (req, res, next) => {
let isLogin = false // 用户登录状态
if (isLogin) {
next() // 登录了向下执行
}else {
res.send('请先登录后访问') // 未登录时拦截
}
})
app.use('/index', (req, res) => {
res.send('访问成功')
})
- 网站维护公告,在所有路由的最上面定义接收所有请求的中间件,直接为客户端做出响应,网站正在维护中。
// 网站公告
app.use((req, res, next) => {
res.send('当前网站正在维护...')
})
- 自定义404页面(代码一般放在其他中间件之后)
app.use((req, res) => {
// 不设置状态码时,默认是200
res.status(404).send('当前访问的网页不存在')
})
错误处理中间件
- 在程序运行过程中,不可避免出现不可预料的错误。如文件读取失败,数据库连接失败,错误处理中间件可以集中处理这些错误
- 当程序出现错误时,错误信息可通过参数的形式传递给next()方法,即可触发错误处理中间件。
// 引入express框架
const express = require('express')
const fs = require('fs')
// 用框架创建web服务器
const app = express()
app.use('/index', (req, res, next) => {
fs.readFile('./01.js','utf8', (err, result) => {
if(err != null) {
next(err)
}else {
res.send(result)
}
})
})
// 错误处理中间件
app.use((err, req, res) => {
res.status(500).send(err)
})
// 监听端口
app.listen(3000)
错误信息捕获
- 在node.js中,异步API的错误信息都是通过回调函数获取的,支持Promise对象的异步API发生错误可以通过catch方法捕获。异步函数执行如果发生错误要如何捕获错误呢?
- try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误,但是不能其他类型的API发生的错误。
// 引入express框架
const express = require('express');
const fs = require('fs');
const promisify = require('util').promisify;
const readFile = promisify(fs.readFile);
// 创建网站服务器
const app = express();
app.get('/index', async (req, res, next) => {
try {
await readFile('./aaa.js')
}catch (ex) {
next(ex);
}
})
// 错误处理中间
app.use((err, req, res, next) => {
res.status(500).send(err.message);
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');
请求参数获取
get请求参数获取
Express框架中使用req.query即可获取GET参数,框架内部会将GET参数转换为对象并返回。
// 引入express框架
const express = require('express')
const fs = require('fs')
// 用框架创建web服务器
const app = express()
// get请求参数获取
app.get('/login', (req, res) => {
res.send(req.query)
})
// 监听端口
app.listen(3000)
结果:
post请求获取参数
Express中接收post请求参数需要借助第三方包 body-parser
使用第三方包后,可通过req.body的方式获取参数
js代码:
// 引入express框架
const express = require('express')
const bodyParser = require('body-parser')
// 用框架创建web服务器
const app = express()
// 配置body-parser模板
app.use(bodyParser.urlencoded({ extended: false }))
// post请求参数获取
app.post('/login', (req, res) => {
res.send(req.body)
})
// 监听端口
app.listen(3000)
html代码:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>Document</title>
</head>
<body>
<form action="http://localhost:3000/login" method="post">
<input type="text" name="username" />
<input type="password" name="password" />
<input type="submit" name="" />
</form>
</body>
</html>
结果:
路由参数
参数获取:req.params
// 引入express框架
const express = require('express')
// 用框架创建web服务器
const app = express()
app.get('/login/:name/:age', (req, res) => {
res.send(req.params)
})
// 监听端口
app.listen(3000)
静态资源的处理
通过Express内置的express.static可以方便地托管静态文件
// 引入express框架
const express = require('express')
const path = require('path')
// 用框架创建web服务器
const app = express()
app.use(express.static(path.join(__dirname,'public')))
// 监听端口
app.listen(3000)
这样处理后可方便访问静态资源
例如访问css文件夹下的base.css文件
express-art-template模板引擎
- 为了使art-template模板引擎能够更好的和Express框架配合,模板引擎官方在原art-template模板引擎的基础上封装了express-art-template。
- 使用npm install art-template express-art-template命令进行安装。
// 引入express框架
const express = require('express')
const path = require('path')
const app = express()
// 设置express框架中使用什么模板引擎渲染什么后缀的模板文件
// 参数1:模板文件后缀
// 参数2:模板引擎
app.engine('html',require('express-art-template'))
// 设置模板文件地址
app.set('views', path.join(__dirname, 'views'))
// 设置模板文件的默认后缀,注意细节view没有s
app.set('view engine', 'html')
app.get('/index', (req, res) => {
res.render('index', {
msg:'模板引擎的使用'
})
})
// 监听端口
app.listen(3000)
res.render都干了些什么?
- 拼接模板路径
- 拼接模板后缀
- 指定要拼接模板和数据
- 将拼接结果响应给客户端
对于公共数据可使用app.locals对象
将变量设置到app.locals对象下面,这个数据在所有的模板中都可以获取到
- js代码:
// 引入express框架
const express = require('express')
const path = require('path')
const app = express()
// 设置express框架中使用什么模板引擎渲染什么后缀的模板文件
app.engine('html',require('express-art-template'))
// 设置模板文件地址
app.set('views', path.join(__dirname, 'views'))
// 设置模板文件的默认后缀
app.set('view engine', 'html')
app.locals.user = [{
name: 'zhangsan',
age: 20
},{
name: '李四',
age: 30
}]
app.get('/index', (req, res) => {
res.render('index', {
msg: '首页'
})
});
app.get('/list', (req, res) => {
res.render('list', {
msg: '列表页'
});
})
// 监听端口
app.listen(3000)
- index.html
{{msg}}
<ul>
{{each user}}
<li>{{$value.name}} {{$value.age}}</li>
{{/each}}
</ul>
- list.html
{{msg}}
<ul>
{{each user}}
<li>{{$value.name}} {{$value.age}}</li>
{{/each}}
</ul>
- 结果: