Express
- 什么是 Express Express是基于Node.js平台的一个Web服务器开发框架。
Express的作用与http模块类似,是专门用来创建Web服务器的。实际上Express就是用原生的http模块封装出来的。
Express也是npm上的一个第三方包,因此我们可以通过npm下载。
-
Express 的作用 使用Express可以方便、快捷地创建Web网站服务器和API接口服务器。
-
Express 的基本使用
// 导入 express 模块
const express = require('express')
// 创建服务器
const app = express()
// 监听客户端的 GET 请求
app.get('/user', (req, res) => {
// req.query 是一个对象,存放着GET请求里的查询字符的内容,默认为空
console.log(req.query); // { name: 'lee', age: '20' }
// 调用 express 提供的 send 方法向客户端响应一个 JSON 对象
res.send({ name: 'lee', id: 7 });
})
// 监听客户端的 POST 请求
app.post('/user', (req, res) => {
// 调用 express 提供的 send 方法向客户端响应一个文本字符串
res.send('POST 请求成功')
})
// 启动服务器
app.listen(8080, () => {
console.log('express server running at http://127.0.0.1:8080');
})
- nodemon 在编写和调试Node.js代码的时候,如果修改了项目的代码,就需要频繁重启服务器,非常繁琐。
因此我们需要下载一个第三方包——nodemon,它可以监听项目文件的变动,当代码被修改后会自动帮助我们重启服务器。
我们只需要用nodemon xxx来启动项目来替代之前用node xxx启动项目就行了。
路由
路由就是一种映射关系,在express中,路由的存在就保证了一个请求可以对应一个响应。
const express = require('express')
// 创建服务器
const app = express()
//创建路由
const router = express.Router()
// 挂载GET路由
router.get('/', (req, res) => {
res.send('GET')
})
// 挂载POST路由
router.post('/', (res, req) => {
res.send('POST')
})
// 注册路由
app.use(router)
// 启动服务器
app.listen(8081, () => {
console.log('express server running at http://127.0.0.1:8081')
})
中间件
中间件就是中间处理环节。
express的中间件本质上就是一个函数,它与路由函数的区别是必须含有next函数。
next函数是实现多个中间件连续调用的关键,它表示把流转关系转交给下一个中间件或路由。
一个请求所经过的所有中间件都共享同一份req和res,我们可以利用这一点完成许多事。
- 全局中间件 全局中间件是所有的请求都会触发的中间件。
const express = require('express')
const app = express()
// 注册全局中间件函数
app.use((req, res, next) => {
console.log('这是第一个中间件');
let nowDate = new Date();
req.date = nowDate;
next();
})
app.use((req, res, next) => {
console.log('这是第二个中间件');
let addSomething = 'something';
req.something = addSomething;
next();
})
app.get('/', (req, res) => {
console.log(req.date);
console.log(req.something);
res.send(req.date + '-----' + req.something);
})
app.listen(80, () => {
console.log('http://127.0.0.1');
})
- 局部中间件 局部中间件函数只会在某一个请求上被执行。
const express = require('express')
const app = express()
// 定义局部中间件
const mw1 = function (req, res, next) {
console.log('这是第一个局部中间件');
req.something1 = 'Citizen7'
next();
}
const mw2 = function (req, res, next) {
console.log('这是第二个局部中间件');
req.something2 = 'Lee'
next();
}
// 某个请求
app.get('/', mw1, mw2, (req, res) => {
console.log('GET请求');
res.send(req.something1 + '---' + req.something2);
})
// 启动服务器
app.listen(8080, () => {
console.log('http://127.0.0.1:8080');
})
- 错误级别中间件
错误级别的中间件必须有四个参数,且第一个必须是
err,并且这个中间件必须写到所有路由的最后(其他的中间件都必须写在路由之前)。
const express = require('express')
const app = express()
// 在某个请求中出现了一个错误
app.get('/', (req, res) => {
throw new Error('错误!');
})
// 错误级别中间件
app.use((err, req, res, next) => {
console.log(err.message);
res.send('出现错误:' + err.message)
})
// 启动服务器
app.listen(8080, () => {
console.log('http://127.0.0.1:8080');
})
- Express 内置中间件 在Express中内置了3个常用的中间件:
express.static——快速托管静态资源的内置中间件。express.json——解析JSON格式的请求体数据。express.urlencoded——解析URL-encoded格式的请求体数据。
CORS
CORS(Cross-Origin Resource Sharing)即跨域资源共享,由一系列HTTP响应头组成,这些HTTP响应头决定浏览器是否阻止前端JS代码跨域获取资源。
浏览器的同源安全策略会默认阻止网页跨域获取资源。但如果接口服务器配置了CORS相关的HTTP响应头,就可以解除浏览器端的跨域访问限制。
注意,只有支持XMLHttpRequest Level 2的浏览器才能支持CORS。
此外,CORS其实还是Express的一个第三方中间件。
-
安装
npm install cors -
使用
const express = require('express')
const app = express()
// 配置解析表单数据的中间件(内置中间件)
app.use(express.urlencoded({ extended: false }))
// 配置 cors 中间件(一定要在所有路由之前)
const cors = require('cors')
// 注册 cors 中间件
app.use(cors())
// 导入路由模块
const router = require('./apiRouter.js')
// 把路由模块注册到 app 上,并限定路径前缀是 /api
app.use('/api', router)
// 启动服务器
app.listen(8080, () => {
console.log('express server running at http://127.0.0.1:8080.');
})
// apiRouter.js 路由模块
const express = require('express')
const router = express.Router()
router.get('/get', (req, res) => {
// 通过 req.query 获取客户端的查询字符串
const query = req.query
res.send({
msg: 'GET请求成功',
data: query
})
})
router.post('/post', (req, res) => {
// 通过 req.body 获取客户端发送到服务器的请求体内容
const body = req.body
res.send({
msg: 'POST请求成功!',
data: body
})
})
module.exports = router