Koa2是一个基于Node实现的Web框架,特点是优雅、简洁、健壮、体积小、表现力强。它所有的功能通过插件的形式来实现。
本文主要介绍如何自己实现一个简单的Koa,通过这种方式来深入理解Koa原理,尤其是中间件部分的理解。Koa的具体实现可以看的koa的源码。
// koa 的简单使用
const Koa = require('koa')
const app = new Koa()
app.use(async ctx => {
ctx.body = 'Hello World';
})
app.listen(3000)
通过上面的代码,如果要实现koa,我们需要实现三个模块,分别是http的封装,ctx对象的构建,中间件机制的实现,当然koa还实现了错误捕获和错误处理。
封装http模块
通过阅读Koa2的源码可知Koa是通过封装原生的node http模块。
// server.js
const http = require('http')
const server = http.createServer((req, res) => {
res.writeHead(200)
res.end('hello world')
})
server.listen(3000, () => {
console.log('server running on port 3000')
})
以上是使用Node.js创建一个HTTP服务的代码片段,关键是使用http模块中的createServer()
方法,接下来我们对上面这面这部分过程进行一个封装,首先创建application.js,并创建一个Application类用于创建Koa实例。通过创建use()
方法来注册中间件和回调函数。并通过listen()
方法开启服务监听实例,并传入use()
方法注册的回调函数,如下代码所示:
// application.js
let http = require('http')
class Application {
constructor () {
this.callback = () => {}
}
listen(...args) {
const server = http.createServer((req, res) => {
this.callback(req, res)
})
server.listen(...args)
}
use(callback){
this.callback = callback
}
}
module.exports = Application
接下来创建一个server.js,引入application.js进行测试
// server.js
const MiniKoa = require('./application')
const app = new MiniKoa()
app.use((req, res) => {
res.writeHead(200)
res.end('hello world')
})
app.listen(3000, () => {
console.log('server running on port 3000')
})
启动后,在浏览器中输入localhost:3000就能看到显示"hello world"。这样就完成http server的简单封装了。
构造ctx对象
Koa 的 Context 把 Node 的 Request 对象和 Response 对象封装到单个对象中,并且暴露给中间件等回调函数。比如获取 url,封装之前通过req.url
的方式获取,封装之后只需要ctx.url
就可以获取。因此我们需要达到以下效果:
app.use(async ctx => {
ctx // 这是 Context
ctx.request // 这是 koa Request
ctx.response // 这是 koa Response
});
JavaScript 的 getter 和 setter
在此之前,需要了解 setter 和 getter 属性,通过 setter 和 getter 属性,我们可以自定义属性的特性。
// test.js
let person = {
_name: 'old name',
get name () {
return this._name
},
set name (val) {
console.log('new name is: ' + val)
this._name = val
}
}
console.log(person.name)
person.name = 'new name'
console.log(person.name)
// 输出:
// old name
// new name is: new name
// new name
上面的代码在每次给name
属性赋值的时会打印new name is: new name
,添加了console.log
这个行为,当然还可以做许多别的操作
构造 context
因此,我们可以使用 getter 和 setter 来构造 context,如下所示:
const http = require('http')
// 获取 request 的 url
let request = {
get url() {
return this.req.url
}
}
let response = {
get body() {
return this._body
},
set body(val) {
this._body = val
}
}
let context = {
get url() {
return this.request.url
},
get body() {
return this.response.body
},
set body(val) {
this.response.body = val
}
}
class Application {
constructor() {
// this.callback = () => {}
// 把 context、request 和 response 挂载到 Application 里面
this.context = context
this.request = request
this.response = response
}
use(callback) {
this.callback = callback
}
// 改造 listen
listen(...args) {
// 可能是一个 异步函数 因此需要 async
const server = http.createServer(async (req, res) => {
let ctx = this.createCtx(req, res)
// 此时就可以直接给callback一个 ctx
await this.callback(ctx)
// this.callback(req, res)
// 此时的 ctx.body 是可以直接获取的
/**
* get body() {
* return this.response.body
* }
*/
ctx.res.end(ctx.body)
})
server.listen(...args)
}
// 把原生的 req 和 res 挂载到 ctx 上
createCtx(req, res) {
// 模拟 req 和 res
let ctx = Object.create(this.context) // 生成 context 对象,里面挂载 body 和 url
ctx.request = Object.create(this.request) // 把 request 挂载到 ctx 上
ctx.response = Object.create(this.response) // 把 response 挂载到 ctx 上
// 把原生的 req 和 res 都挂载到 request 和 response 以及 ctx 上
ctx.req = ctx.request.req = req
ctx.res = ctx.response.res = res
return ctx
}
}
这时,我们就可以通过 ctx 来获取 url 了
// server.js
const MiniKoa = require('./application')
const app = new MiniKoa()
// 此时可以使用 ctx
app.use(async (ctx) => {
ctx.body = 'ctx url: ' + ctx.url
})
app.listen(3000, () => {
console.log('server running on port 3000')
})
// 在浏览器输入 localhost:3000/path
// 浏览器显示 ctx url: /path
Koa中间件及洋葱圈模型的理解与实现
koa洋葱圈模型koa的中间件机制是一个洋葱圈模型,通过use()
注册多个中间件放入数组中,然后从外层开始往内执行,遇到next()
后进入下一个中间件,当所有中间件执行完后,开始返回,依次执行中间件中未执行的部分,如上图所示。
在实现之前,我们先来了解一下中间件的原理,根据中间件的原理可知,要层层递进执行多个函数,比如下面的例子
// test.js
function add (x, y) {
return x + y
}
function double (z) {
return z * 2
}
const res1 = add (1, 2)
const res2 = double (res1)
console.log(res2) // 6
上面的例子中,我们把add()
函数传入double()
中,把函数作为参数,这样最终就会先执行add()
然后执行double()
,这时我们把这种模式编写成一个通用的compose()
函数。
// test.js
function add(x, y) {
return x + y
}
function double(z) {
return z * 2
}
// 把需要执行的函数都按顺序放到一个数组里,类似于koa中间件的use()方法
const middleware = [add, double]
let len = middleware.length
// compose 把所有函数都压成一个函数
function compose(middleware) {
return (...args) => {
// step1: 先把第一个函数拿出来执行一下,作为初始值
let res = middleware[0](...args)
// step2: 初始值执行完成之后塞给第二个函数
for (let i = 1; i < len; i++) {
// 从 1 开始遍历,把所有的函数都执行一下
// 把执行的结果传给下一个函数
res = middleware[i](res)
}
return res
}
}
const fn = compose(middleware)
const res = fn(1, 2)
console.log(res) // 6
上面的compose()
函数还有一个缺点,它是一个同步的方法,并没有异步的等待,如果要使用异步,直接使用for
循环是不行的,它不能等待异步执行完毕,此外 koa 还对外暴露了next()
方法来实现异步等待,它是一个Promise
,当执行到它时就执行下一个中间件。
// test.js
async function fn1(next) {
console.log('fn1')
await next()
console.log('end fn1')
}
async function fn2(next) {
console.log('fn2')
await delay()
await next()
console.log('end fn2')
}
async function fn3(next) {
console.log('fn3')
}
function delay() {
return new Promise((resolve, reject) => {
setTimeout(() => {
resolve()
}, 2000)
})
}
function compose(middleware) {
// console.log(middleware)
// [ [AsyncFunction: fn1], [AsyncFunction: fn2], [AsyncFunction: fn3] ]
return () => {
// 先执行第一个函数
return dispatch(0)
function dispatch(i) {
let fn = middleware[i]
// 如何不存在直接返回 Promise
if (!fn) {
return Promise.resolve()
}
// step1: 返回一个 Promise,因此单纯变成一个 Promise 且 立即执行
// step2: 往当前中间件传入一个next()方法,当这个中间件有执行 next 的时候才执行下一个中间件
return Promise.resolve(fn(function next() {
// 执行下一个中间件
return dispatch(i + 1)
}))
}
}
}
const middleware = [fn1, fn2, fn3]
const finalFn = compose(middleware)
finalFn()
// fn1
// fn2
// 等待两秒
// fn3
// end fn2
// end fn1
上面已经实现一个了一个简单的中间件示例,接下来再把它整合到 Application 类中
// Application.js
const http = require('http')
let request = {
get url() {
return this.req.url
}
}
let response = {
get body() {
return this._body
},
set body(val) {
this._body = val
}
}
let context = {
get url() {
return this.request.url
},
get body() {
return this.response.body
},
set body(val) {
this.response.body = val
}
}
class Application {
constructor() {
this.context = context
this.request = request
this.response = response
this.middleware = []
}
use(callback) {
// 创建一个 middleware 数组,通过 push 传入多个 callback
// 然后通过 compose 控制整个 middleware 执行的顺序
// 每个 callback 回调函数给两个参数 第一个是 context 第二个是 next
this.middleware.push(callback)
// this.callback = callback
}
// 直接把 compose 移植过来
compose(middleware) {
// 每个中间件需要一个 context
return function (context) {
return dispatch(0)
function dispatch(i) {
let fn = middleware[i]
if (!fn) {
return Promise.resolve()
}
// 中间件第一个参数是一个 context,第二个参数是 next()
return Promise.resolve(fn(context, function next() {
return dispatch(i + 1)
}))
}
}
}
listen(...args) {
const server = http.createServer(async (req, res) => {
let ctx = this.createCtx(req, res)
// await this.callback(ctx)
// 这里不能直接执行 callback 而是先获取经过 compose 处理后的中间件集合
const fn = this.compose(this.middleware)
await fn(ctx)
ctx.res.end(ctx.body)
})
server.listen(...args)
}
createCtx(req, res) {
let ctx = Object.create(this.context)
ctx.request = Object.create(this.request)
ctx.response = Object.create(this.response)
ctx.req = ctx.request.req = req
ctx.res = ctx.response.res = res
return ctx
}
}
module.exports = Application
这时一个精简的 koa 就实现了,我们来测试它是否好用
// server.js
const MiniKoa = require('./application')
const app = new MiniKoa()
function delay() {
return new Promise((resolve, reject) => {
setTimeout(() => {
resolve()
}, 2000)
})
}
app.use(async (ctx, next) => {
ctx.body = '(fn1) '
await next()
ctx.body += '(end fn1) '
})
app.use(async (ctx, next) => {
ctx.body += '(fn2) '
await delay()
await next()
ctx.body += '(end fn2) '
})
app.use(async (ctx, next) => {
ctx.body += '(fn3) '
})
app.listen(3000, () => {
console.log('server running on port 3000')
})
// 浏览器输出:(fn1) (fn2) (fn3) (end fn2) (end fn1)
总结
到此为止,一个简单的 Koa 就实现了,但是这里还缺少了异常处理,更详细的实现方式请查看 Koa 源码,无非也只是一些工具函数以及一些功能点的细化,其基本原理大概就是如此了。其中的难点是中间件原理,通过这个例子彻底理解中间件原理后,以后再使用起这个框架来,就更加得心应手了。
网友评论