深入浅出Koa（1）：生成器和Thunk函数

Koa是个小而美的Node.js web框架，它由Express的原班人马打造的， 致力于以一种现代化开发的方式构建web应用。 通过这个系列，你将能够理解Koa的基本原理，并且学习如何正确有效的使用Koa编写Web应用程序。本文主要向你介绍 Koa的一些基础知识，包括生成器，thunks等。

为什么要用Koa?

Koa提供的一些关键特性能够让你尽可能避免回调函数的情况下简单快捷的编写web应用。Koa使用了ES6中的一些新的语言 特性来让Node应用的控制流管理变得更加简单。

Koa本身非常的小。与当下其他流行的web框架（例如Express）不同的是，Koa从一出生开始就采用了一种极致模块化的方案， 意味着每个模块做且只做一件事情。请牢记这一点，让我们开始吧。

Hello Koa

在开始之前，为了能够用node运行本文中的例子或你自己写的ES6代码 （如果你使用的是node v4以下版本，则需要加上--harmony，建议你升级到Node的最新版本）。

正如你从上面的例子中看到的那样，使用Koa来编写一个web服务器并没有什么特别的地方，除了那个奇怪的跟在function 关键字后的*符号。好吧，如果你了解ES6的话，我想你应该知道这个符号意味着该函数现在是生成器函数了。

生成器 Genderators

想象这样的一个场景，当你执行一个函数的时候，你可以在某个点暂停函数的执行，做一些其它工作，计算一些其他值， 然后返回到函数，甚至是携带一些新的值继续函数的执行。

可以认为生成器就是某种迭代器（类似于循环）。当然，这也是生成器函数最擅长做的事，生成器是ES6的新特性。因此我们可以*的使用它。

我们来试着使用一下生成器！首先，你得创建一个生成器函数，这与我们创建普通函数没有太大的差别，唯一的区别在于， 在function关键字后面需要添加*符号。例如：

如上，现在我们就创建了一个生成器函数。当我们调用这个函数时，它会返回一个迭代器对象。因此与一般函数不同的是， 当我们调用一个生成器时，代码并不会立即执行，正如我们前面所讨论的，我们需要手动的迭代这个迭代器对象。

使用这个返回对象bar，我们可以用来遍历函数中的中断点。可以通过调用迭代器对象bar的next()方法来完成遍历操作。 当next()被调用的时候，函数会从之前暂停的地方执行到下一个暂停点。

但是在继续执行之前，迭代器会返回一个对象，这个对象包含了生成器的的状态信息（即每次调用next()方法时会返回一个对象）。 这个对象包含两个属性，分别是value和done。value表示当前迭代值，done则表示的是迭代是否结束。

正如我们所看到的那样，这个生成器函数中并没有任何的中断点（没有yield关键字）， 因此首次调用next()方法时返回对象的done值为true。这意味着，如果你在生成器函数中指明了return值， 它将会被作为最后一个迭代器对象被返回（也就是done为true）。现在，我们唯一需要所做的是能够暂停迭代器。 正如前面说的那样，在迭代遍历生成器函数时，每次迭代会产出一个值（在暂停点）。 因此，ES6使用yield关键字用于暂停函数。

yield

我们知道，我们可以通过next()方法来启动一个生成器，每当遇到一个yield关键字时，它会暂停执行。 然后返回一个包括value和done属性的对象。此时value值即为yield后的表达式结果。 当然，这个表达式可以是任何表达式。例如：

再次调用next()方法，当前的yield值会被返回，然后继续执行。当然，如果你要在next()方法中接收一个值， 例如next(val)这样，也是可以的，接收的值会在生成器继续执行时被返回。

再次解释一下：第一次调用bar.next()方法时，生成器对象执行到yield 'A'，然后返回{value: 'A', done: false}， value的值即为yield后表达式的值，done表示是否结束。再次调用bar.next('B')，此时已经没有了yield语句， 或者return语句，因此返回对象的value值为undefined。但是因为next()方法接收了一个值B， 因此该值会赋值给val。

错误处理

如果你发现迭代器对象的值发生了错误的话，你可以使用throw()方法在生成器中捕获错误。 使用这种方法，你可以轻松的在生成器完成错误处理的任务。

for…of

在ES6中有一个新的循环类型，可以被用来迭代生成器对象，它就是for...of循环。 使用for...of循环时，迭代会一直执行到done为false时。值得注意的是，如果你使用了这种循环类型， 那么你将不能在next()方法中传值，并且循环会舍弃返回值。

yield *

前面说过，你可以yield几乎任何东西，甚至是生成器。如果你需要yield一个生成器的话，那么需要使用yield *。 这被称为生成器委托（delegation）。这意味着你正在委托给另一个生成器，因此， 你可以使用一个迭代器对象迭代遍历多重嵌套的生成器。

Thunks

如果要彻底理解Koa，Thunk是另一个需要搞懂的重要概念。Thunk函数是一个偏函数，执行它会得到一个新的只带一个回调参数的函数。 某种程度上，我们可以将它与lazy evaluation联系在一起。 我们来看一下例子：

上面的示例代码中，read函数时一个典型的Thunk函数，执行read('package.json')后我们可以获得一个只有回调参数的新函数。

Thunkify

我们可以利用一个叫thunkify小模块， 将普通的node函数转换为thunk函数。你可能会问，我们为什么需要这么做？因为我们在使用生成器函数， 事实证明，它可以让你轻松的在生成器函数中避免使用回调函数。

为了能够在生成器函数中试用thunk函数，我们首先需要做的是将原先的含回调的普通node函数转为thunk函数。 如果不这样做，我们就必须使用回调来进行处理。当我们调用next()方法时，此刻返回的value值是一个函数， 该函数的参数是一个被thunk化的函数的回调。在回调函数中，我们可以检查错误（使用throw关键字）， 或者调用next()方法获取接收到的数据。

解释一下上面的执行流程：

1. 我们利用thunkify模块将原生方法fs.readFile转为thunk化后的read()函数。 注意！read()函数是个thunk函数。
2. 定义一个生成器函数，yield后的是一个thunk化的read()函数。
3. 调用这个生成器函数，将返回的迭代器对象赋值给gen。
4. 调用next()方法，返回的value值是一个函数，该函数接收一个callback，这个callback其实就是被thunk化的 read()函数的callback。我们可以利用这个callback来执行处理。

你需要花点时间来理解上面代码中的每一个部分，因为这对于理解Koa非常的关键。希望你能更多的关注到代码中的生成器部分。 它拥有同步代码的简洁性，使用了合理的错误处理，但是需要注意的是，它仍然是异步代码。

本文是Koa系列的第一篇，后面还会继续介绍Koa。

Statement

原文地址： https://blog.risingstack.com/introduction-to-koa-generators/

References

1. https://blog.risingstack.com/introduction-to-koa-generators/
2. http://purplebamboo.github.io/2014/05/24/koa-source-analytics-1/

深入浅出Koa（2）：co的实现和使用

在之前的文章中，
我们介绍了Koa的基础知识，主要涉及了ES6生成器的相关知识，借助于生成器，我们可以使用同步风格的代码编写异步代码，
这么做可以让异步编程变得更加简单，也让代码更可读，本文我们将要介绍的是co，它是Koa的实现基础。

简单回顾

这是前一篇文章中的最后一个例子，正如你看到的那样，我们可以将程序分为三个重要部分。
首先，我们需要创建了一个被thunk化的函数，我们将在生成器中使用到这个thunk函数。
然后，我们可以编写我们的生成器函数，并在函数中使用前面创建的thunk函数。 最后，我们调用并遍历生成器，并进行错误处理等工作。如果你仔细的考虑了这个过程，
你会发现最后一个部分和整个程序的核心内容并没有太大的关联。它只不过是用来让我们运行生成器而已。 因此，我们可以利用一个工具来简化这个过程，幸运的是，正好有一个这样的模块，他就是co。

co

Co是一个基于生成器的Node流程控制模块。下面的例子所做的工作与前一个例子完全一样， 但是我们没有直接编写调用生成器的代码（上面代码的第三部分）。取而代之的是，我们将生成器直接传递给了co函数， 然后立即调用这个函数，任务就这么神奇的完成了。其实，也没什么神奇的，co只不过是帮你完成了生成器调用代码而已， 因此我们没必要担心下层的工作。

正如你已经知道的那样，你可以在yield后面跟上任何你需要计算（用于获取某些值、执行某些任务）的表达式。因此， 不仅仅是thunk函数可以跟在yield后面。由于co主要用来创建更简单的控制流，因此它只能用来yield一些特定类型。 目前主要可以在co中被yield的类型有：

• thunks（函数）
• 数组（并行执行）
• 对象（并行执行）
• 生成器（代理）
• 生成器函数（代理）
• Promises

前面我们已经讨论了thunks是如何工作的，因此下面我们来讨论一些其他内容。

co的简单实现

co的异步解决方案主要建立在Thunk函数的基础上。使用co时，yield后的表达式经常是Thunk函数。 前面的文章中，我们已经介绍过，你可以借助诸如thunkify这样的模块来包裹原来的函数。 有了co后，我们可以使用这样的方式来进行异步编程：

程序的输出结果大概是这样的：

在上面的代码中，我们使用yield来直接获取异步函数size()的值，但代码简直和同步代码没什么两样。 这样做的好处是，让我们不再关心回调函数可能引发的回调地狱问题。实际上，co本质上也可以看成是一个Thunk函数， 它接收了一个生成器函数作为参数，并生成了一个实际操作函数，而这个函数正是通过接收回调的方式来传入最后的返回值。

下面我们来看下如何实现一个最简单的co：

我们说过，co本质上也是一个Thunk函数，它需要传入一个生成器函数，它能够帮你不停的调用所传入生成器的next函数， 如果done微true，则代表生成器函数已经迭代完成，并将值传给回调函数。这里需要注意_next函数的实现， 它实际上会成为前面的yield的函数的回调函数。

比如之前的代码中的size('file1.txt')会返回一个带回调的函数a。这里有个约定， 就是Thunk函数的回调一般都是function (err,res)
{ }的格式，实际上这也是node实际的规范。

上面我们实现了一个简单的co函数，已经可以支持最基本的同步调用了，但很多时候，我们还需要在yield后面处理其他的值， 比如一个数组或者对象，我推荐你阅读这篇博文。
当然，最重要的还是阅读co的源码。

co v4使用指南

下面看完了co的源码，我们来看看如何使用co，它的最新版本是v4，这个版本主要依赖于promise。

并行执行

如果你yield了一个数组或对象，它会并行的计算数组或对象中的内容。当然，如果集合中的内容为thunks或生成器， 它也能同样进行处理。并且你也可以进行嵌套，它能够便利你的数组或对象，然后并行的执行工作函数。需要记住的是: yield后的生成的结果并不是扁平的，而是保持和原来相同的结构。

你也可以在thunk调用后进行yield，同样能达到并行的目的。

委托

前面说过，你也可以在yield后面跟上生成器。注意你可以不必使用yield *;

我们大致尝试用co处理了每一种可以被yield的类型。下面我们来看最后一个例子，算作总结。

我想目前为止你应该能够对生成器有了一个较为清晰的认识了，并且能够借用co很好的处理异步控制流。关于co本身， 如果你想了解的更深入些，可以阅读它的源代码。现在，我们将重点移到Koa本身上来。

小结

本文为你介绍了Koa的实现基础co，它能够让你的node应用避免回调地狱。后面我们会继续介绍Koa的使用与实现。

Statement

原文地址：https://blog.risingstack.com/getting-started-with-koa-part-2/

References

1. Koa的一些例子
2. 中间件列表
3. Wikijava
4. Koa最佳实践指南

深入浅出Koa（3）：Koa的入门和实现

Nov 25, 2015

前面我们了解Koa的两大基础：生成器和co，Koa是基于这两者之上的新一代的Node中间件框架。
为了能够让你更透彻的理解Koa，本文将要介绍的是Koa的实现。

Koa入门

对于Koa而言，你需要知道的并没有很多。如果你阅读了它的源代码的话，你甚至会发现总共才4个文件，每个才300行左右。 Koa遵循了每个程序只做一件事并将其做的更好的原则。你会发现，每个优秀的Koa模块都非常的紧凑，并且只做一件事， 并且在其他模块的基础上进行构建。你应该记住这一点，并使用这个方法来开发你自己的Koa模块。这将会有益于所有人， 也有助于你和其他人阅读源代码。先记住这一点后，然后我们来看看Koa的一些核心特性。

应用 Application

创建一个Koa应用只不过是在调用一个相关的模块函数而已。它会提供给你一个对象，这个对象包含一个生成器数组
（一组中间件），对收到的每个请求，它会使用一种堆栈式的方法执行。

级联 Cascading

当你使用Koa时，一个非常重要的术语是中间件。现在让我们来搞清楚这个概念。

Koa中的中间件是一组用于处理请求的函数。使用Koa创建的服务器，可以有一组堆栈结构的中间件与它关联。

级联在Koa中意味着：控制流会流经一组中间件。在web开发中这个概念非常的有用，你可以将复杂的行为借助于这个手段变得简单。 Koa通过生成器函数来实现这一点（中间件级联），并且更具创新性和简洁性。 它能够yiled下游中间件，之后控制流再返回到上游中间件。 将生成器加入到控制流中非常简单，只要在调用use()方法时使用生成器即可。 猜猜下面的代码为什么每次接收到请求时会输出的是A, B, C, D, E。

下面的代码演示了一个服务器，因此listen方法用于监听一个具体的端口：

当一个新的请求进来的时候，它会流经一系列的中间件（即按照use方法调用的顺序1-2-3）。因此在上面的示例代码中， 请求首先经过第一个中间件，它会首先输出A，然后它遇到了yield next语句，这会使它转入下一个中间件计算相应的结果， 只有在处理完后才回到离开的地方。因此，接下来会转入到下一个中间件打印B，再次碰到yield next， 转入下一个中间件，打印C。现在已经没有更多的中间件了，因此执行完第三个中间件就会回流，首先回到第二个中间件，
继续执行打印出D，中间件2的代码执行完毕，再回流到第一个中间件，打印E。

到目前为止，Koa模块本身并没有什么复杂的地方，因此没有必要再追溯那些你可以在文档中就能知道的信息。 我推荐你直接去阅读Koa的文档去了解关于Koa的详细使用说明，其实也没有什么复杂的内容，所以这里也就不再多介绍了。 这里列出相关文档的链接：

• Context
• Request
• Response
• 其他

让我们再来看一个例子（这个例子来源于Koa的官网），它利用了一些HTTP特性。第一个中间件计算了响应的时间。 你会发现获取响应开始和结束的时间非常简单。并且在Koa中你可以优雅的将这些功能模块分离开。

Koa的实现

下面我们来看看koa的源代码，为了简单起见，我们解读的是v1.x的源码。 本部分的内容主要参考了阮一峰的koa介绍的博文。 koa项目的入口文件时lib/application.js，代码的框架大致如下：

app.use()用于注册中间件，即将生成器函数放入中间件数组：

app.listen()就是将http.createServer(app.callback()).listen(...)封装了一层：

在上面的代码中，app.callback()会返回一个函数，用来处理HTTP请求。它的第一行代码用于将respond函数放入this.middleware， 现在mw数组就包括了[respond, s1, s2, s3]。

compose(mw)用于将中间件数组转为一个层层调用的生成器函数。我们来看它的源码：

在上面的代码中，下一个生成器函数总是上一个生成器函数的参数，从而保证了层层调用。 var fn = co.wrap(gen)则是将生成器函数包装成自动执行的函数，并且返回一个Promise。

将所有的上下文变量都放进context对象中：

而真正处理HTTP请求的是下面这个生成器函数：

总结

现在你已经熟悉了Koa的核心内容， 虽然使用旧的框架也能够完成相关的任务，但是现在你可以尝试Koa这个新的框架来解决以前的问题。因为， 在旧的框架中可能有非常多的功能是你从来都用不到的，或者某些并不是按照你的设想工作的。
现在，以Koa为代表的现代Node框架能够为你带来这些改变。你可以使用更轻量级的核心，
然后通过npm引入你需要的模块到你的app中，这种方式下你能够完全的控制哪些模块是你需要用的。

'use strict';

var s = 'Hello';

functiongreet(name) {

    console.log(s + ', ' + name + '!');

}

module.exports = greet;

'use strict';

// 引入hello模块:

var greet = require('./hello');

var s = 'Michael';

greet(s); // Hello, Michael!

var greet = require('./hello');

var greet = require('./hello'); // 不要忘了写相对目录!

var greet = require('hello');

module.js

    throw err;

          ^

Error: Cannot find module 'hello'

    at Function.Module._resolveFilename

    at Function.Module._load

    ...

    at Function.Module._load

    at Function.Module.runMain

module.exports = variable;

var foo = require('other_module');

var s = 'global';

var s = 'Hello';

var name = 'world';

console.log(s + ' ' + name + '!');

(function() {

    // 读取的hello.js代码:

    var s = 'Hello';

    var name = 'world';

    console.log(s + ' ' + name + '!');

    // hello.js代码结束

})();

// 准备module对象:

var module = {

    id: 'hello',

    exports: {}

};

var load = function(module) {

    // 读取的hello.js代码:

    functiongreet(name) {

        console.log('Hello, ' + name + '!');

    }

    module.exports = greet;

    // hello.js代码结束

    return module.exports;

};

var exported = load(module);

// 保存module:

save(module, exported);

module.exports = greet;

var greet = require('./hello');

// hello.js

functionhello() {

    console.log('Hello, world!');

}

functiongreet(name) {

    console.log('Hello, ' + name + '!');

}

functionhello() {

    console.log('Hello, world!');

}

module.exports = {

    hello: hello,

    greet: greet

};

// hello.js

functionhello() {

    console.log('Hello, world!');

}

functiongreet(name) {

    console.log('Hello, ' + name + '!');

}

functionhello() {

    console.log('Hello, world!');

}

exports.hello = hello;

exports.greet = greet;

// 代码可以执行，但是模块并没有输出任何变量:

exports = {

    hello: hello,

    greet: greet

};

var module = {

    id:'hello',

    exports: {}

};

var load = function (exports, module) {

    // hello.js的文件内容

    ...

    // load函数返回:

    return module.exports;

};

var exported = load(module.exports, module);

exports.foo = function() {return'foo'; };

exports.bar = function() {return'bar'; };

module.exports.foo = function() {return'foo'; };

module.exports.bar = function() {return'bar'; };

module.exports = function() {return'foo'; };

module.exports = {

    foo: function() {return'foo'; }

};

module.exports = function() {return'foo'; };