koa2是什么
框架
- 封装原生代码的 API
- 规范流程和格式
- 让开发人员更加关注于业务代码，提高开发效率
框架frame和库lib的区别
- 框架是唯一的，库就可以共存，即：一个项目中只能使用一个框架，但可以同时多个库
- 框架关注全流程，库关注单个功能
- 类比 Vue 和 lodash
什么是koa2
koa2 是 nodejs web server 框架
- 官网和文档 https://koa.bootcss.com/
- 通过 async/await 语法【处理异步】高效编写web server
- 中间件机制，能合理拆分业务代码
单独使用koa插件
- 初始化项目 npm init
- 安装koa2 npm install koa --save
const Koa = require('koa') // 引入koa
const app = new Koa() // 实例化
app.use(async(ctx) => {
ctx.body = 'hello world'
})
app.listen(3000) // web server 监听的 3000端口
koa2环境搭建
- 全局安装脚手架
npm install -g koa-generator - 查看版本
koa2 --version - 创建项目
koa2 test(test文件夹名称) - 启动项目
npm run dev - 访问
localhost:3000
koa路由使用方式
- 创建路由
const router = require('koa-router')()
// 设置前缀
router.prefix('/api')
router.get('/list', function(ctx, next) {
ctx.body = 'api list'
})
router.post('/create', function(ctx, next) {
ctx.body = 'api create'
})
// 导出
module.exports = router
- app.js中引入路由
const comments= require('./routes/comments')
- app.js中注册路由
app.use(comments.routes(), comments.allowedMethods())
image.png
image.png
koa2处理http请求
ctx 即 res 和 req的集合，用来处理接收和返回数据
-
ctx.query获取get请求的参数集合
image.png -
ctx.request.body获取post请求的参数集合
image.png ctx.body设置响应数据
koa2中间件
1、为什么使用中间件
- 拆分业务模块，使代码清晰
- 统一使用中间件，使得各业务代码都规范标准
- 扩展性好，易添加、易删除.
2、koa2业务代码都是中间件
- app.use(..)都属于中间件， 所有的请求都会经过中间件
- 路由也是中间件，只有满足路由规则才会进入这个中间件
3、中间件规则
- 不管是什么类型的中间件（路由的或者自定义的），它都是一个async函数。async函数的第一个参数是ctx，第二个参数是next。
模拟登陆 中间件
app.js中添加中间件逻辑代码
app.use(async(ctx, next) => {
const query = ctx.query
if (query.user === 'zhangsan') {
// 模拟登陆成功
await next() // 执行下一个重甲件
} else {
// 登陆失败
ctx.body = "请登录"
}
})
image.png
user参数正确时
image.png
koa2洋葱圈模型
- 中间件机制，是koa2的精髓
- 每个中间件都是async函数
- 中间件的运行机制，就像洋葱圈
洋葱圈模型和中间件模型的关系
- 中间件机制：业务模块的划分
- 洋葱圈模型：中间件的执行机制
- 两者要分开来看，不要混在一起
代码示例
// 演示 koa2 中间件的洋葱圈模型
const Koa = require('koa')
const app = new Koa()
// logger
app.use(async (ctx, next) => {
await next() // 执行下一个中间件
const rt = ctx.response.get('X-Response-Time') // 获取 时间差
console.log(`${ctx.method} ${ctx.url} - ${rt}`)
})
// x-response-time
app.use(async (ctx, next) => {
const start = Date.now()
await next() // 执行下一个中间件
const ms = Date.now() - start // 计算时间差，例如 80
ctx.set('X-Response-Time', `${ms}ms`) // 记录/设置 时间差
})
// response
app.use(async (ctx, next) => {
ctx.body = 'Hello world'
})
app.listen(3000)
console.log('koa2 已经开始监听 3000 端口')
