node.js Koa 框架 的中间件用法

Koa 的中间件通过一种更加传统(您也许会很熟悉)的方式进行级联,摒弃了以往 node 频繁的回调函数造成的复杂代码逻辑。 我们通过 generators 来实现“真正”的中间件。 Connect 简单地将控制权交给一系列函数来处理,直到函数返回。 与之不同,当执行到 yield next 语句时,Koa 暂停了该中间件,继续执行下一个符合请求的中间件(‘downstrem’),然后控制权再逐级返回给上层中间件(‘upstream’)。

更多精彩内容请看 web前端中文站
www.lisa33xiaoq.net 可按Ctrl + D 进行收藏

node.js Koa 框架 的中间件用法

Logger 功能

Koa 的最大特色,也是最重要的一个设计,就是中间件(middleware)。为了理解中间件,我们先看一下 Logger (打印日志)功能的实现。

最简单的写法就是在main函数里面增加一行。

看下面的 test.js。

 const main = ctx => {   
 console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);   
 ctx.response.body = 'Hello World'; };

运行上面的 test.js。访问 http://127.0.0.1:3000 ,命令行就会输出日志。

 1502144902843 GET /

中间件的概念

上一个例子里面的 Logger 功能,可以拆分成一个独立函数。看下面的 logger.js 。

 const logger = (ctx, next) => {   
 console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);   
 next(); } 
 app.use(logger);

像上面代码中的logger函数就叫做”中间件”(middleware),因为它处在 HTTP Request 和 HTTP Response 中间,用来实现某种中间功能。app.use()用来加载中间件。
基本上,Koa 所有的功能都是通过中间件实现的,前面例子里面的main也是中间件。每个中间件默认接受两个参数,第一个参数是 Context 对象,第二个参数是next函数。只要调用next函数,就可以把执行权转交给下一个中间件。

运行上面的demo,并访问查看效果。命令行窗口会显示与上一个例子相同的日志输出。

中间件栈

多个中间件会形成一个栈结构(middle stack),以”先进后出”(first-in-last-out)的顺序执行。

  1. 最外层的中间件首先执行。
  2. 调用next函数,把执行权交给下一个中间件。
  3. 最内层的中间件最后执行。
  4. 执行结束后,把执行权交回上一层的中间件。
  5. 最外层的中间件收回执行权之后,执行next函数后面的代码。

请看下面的demo。

 const one = (ctx, next) => {   
 console.log('>> one');   
 next();   
 console.log('<< one'); } 
 const two = (ctx, next) => {   
 console.log('>> two');   
 next();    
 console.log('<< two'); } 
 const three = (ctx, next) => {   
 console.log('>> three');   
 next();   
 console.log('<< three'); } 
 app.use(one); 
 app.use(two); 
 app.use(three);

运行上面这个 demo。我们发现命令行窗口中输出的内容和”先进后出”(first-in-last-out)的执行顺序一致。

如果中间件内部没有调用next函数,那么执行权就不会传递下去。

异步中间件

迄今为止,所有例子的中间件都是同步的,不包含异步操作。如果有异步操作(比如读取数据库),中间件就必须写成 async 函数。

看下面的 async.js 文件中的代码;

 const fs = require('fs.promised'); 
 const Koa = require('koa'); 
 const app = new Koa(); 
 const main = async function (ctx, next) {   
 ctx.response.type = 'html';   
 ctx.response.body = await fs.readFile('./demos/template.html', 'utf8'); }; 
 app.use(main); 
 app.listen(3000);

上面代码中,fs.readFile是一个异步操作,必须写成await fs.readFile(),然后中间件必须写成 async 函数。

demo 的运行效果,大家自己执行一下。

中间件的合成

koa-compose模块可以将多个中件合成为一个。

看下面的?compose.js 文件中的代码。

 const compose = require('koa-compose'); 
 const logger = (ctx, next) => {   
 console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);   
 next(); } 
 const main = ctx => {   
 ctx.response.body = 'Hello World'; }; 
 const middlewares = compose([logger, main]); 
 app.use(middlewares);

demo 效果我就不在说了。

到这里 koa 框架的中间件已经讲完了,如果你还有不懂,可以留言!限于篇幅,我们下一章将学习 koa 框架的错误处理部分,欢迎阅读。

有关node.js下Koa的学习有一个系列的学习教程,大家可以参考着以下资料,循序渐进地掌握Koa框架知识。

1.NODE.JS KOA 框架 的基本用法

2.NODE.JS KOA 框架 的路由用法

3.NODE.JS KOA 框架 的中间件用法

4.NODE.JS KOA 框架 的COOKIES、表单、文件上传功能详解

5.NODE.JS KOA 框架 的错误处理

6.闲谈NODE.JS 的KOA框架和EXPRESS框架

7.NODE.JS对接HYBRID框架VASSONIC教程

【注:本文源自网络文章资源,由站长整理发布】

0
如无特殊说明,文章均为原作者原创,转载请注明出处

该文章由 发布

这货来去如风,什么鬼都没留下!!!
发表我的评论

Hi,请填写昵称和邮箱!

取消评论
代码 贴图 加粗 链接 删除线 签到