koa2 自学笔记(一)

此系列文章会持续更新。。。

从事前端一段时间之后，也开始对后端感兴趣，但是愧于不是科班出身对后端语言一窍不通因此依然想通过前端这个桥梁学习后端。nodejs 为我提供了一条道路，而后选择学习现在比较火的基于 nodejs 平台的 web 开发框架 ---> koa。此文为小生自学的笔记，如果有写的不对的地方，欢迎指点~

说起 koa 就不得不提一下另一个 web 应用框架 express，这两个做的是一个事，但是我还是选择了学习 koa 因为 koa 使用 async/await 来做异步开发，更符合以后的发展趋势。

我使用的是 koa@2.5.0（这个版本号也是没谁了。。。），首先需要注意一点 koa 最新版本依赖 node v7.6.0 或 ES2015 及更高版本和 async 方法支持。node < 7.6 版本需要一些 polyfill，koa 中文网有介绍这里就不赘述了。

koa 本身体积很小，因为它不在内核方法中绑定任何中间件，需要自己根据需求添加不同功能的中间件。所以 koa 应用程序相当于使用包含很多中间件的大对象，按照类似栈堆的方式组织和执行的。

这是 koa 最简单的 hello world 实例，刚开始学建议小伙伴们自己手敲代码别用代码提示来加深影响：

const Koa = require('koa');
const app = new Koa();

app.use(ctx => {
  ctx.body = 'Hello World!';
});

app.listen(3000);

下面是具体看一下 Koa 是怎么运行的：

1. 引入 Koa，之后实例化赋值为 app。
2. 调用 app.use 方法并传入一个 function，此 function 为 ES6 的箭头函数写法，app.use 的意思是将给定的中间件方法添加到此应用程序中。官方提供了很多中间件供大家使用，链接点击此处。
3. app.use 中的 function 接受到了 ctx 参数，ctx 的意思就是上下文(context)，这是一个对象，其中包含了很多对象和方法，比如 request 和 response 等等，后面会详细说到。
4. ctx.body 为 上下文的主体，赋值为 Hello World!
5. app.listen方法的意思是创建并返回一个 HTTP 服务器，将给定的参数传递给 Server#listen()，后面也会详细说到。其中 3000 为端口号。

那如何查看运行代码呢，我们需要建立一个 web 应用程序，首先打开终端初始化项目

# 初始化 package.json
npm init

# 安装 koa
npm install koa

新建一个 index.js 文件将刚才写的代码拷贝到里面。
然后在终端中启动项目，输入指令

node index.js

可以看到 localhost:3000 已经启动~ 成功迈出第一步！

Hello World!

我们回过头来看一下 ctx 参数到底包含了哪些东西，打印出 ctx 对象，它的最基本的数据结构大致是这样的:

context

我们可以看到，里面包含了几个属性，request、response、app、req、res、socket

分别简单说一下：

1. request 就是 koa 的 Request 对象，也就是所谓的上文，里面含有 HTTP 请求的一些参数。
2. response 就是 koa 的Response 对象，也就是所谓的下文，HTTP 请求的响应。
3. app 是应用实例引用，也就是上面例子中的 app 变量（ctx.app 这是属性名是固定的，和例子中的变量名没有关系，别弄混了）。
4. req 是 Node 的 request 对象。
5. res 是 Node 的 response 对象。

注意：可能会有小伙伴在别的教程上面看到 ctx.response.body = '...';不要纠结。。。ctx.body 就是 ctx.response.body 的别名而已，最终指向的都是 koa 的 Request 对象，response 同理。

下一篇我们会讲到 koa2 的路由，谢谢大家~

---

外传：
在讲路由之前，我们需要先了解一下 ES7 中的 async/await 异步编程，这里只举一个简单的例子来展示一个 async/await 的编程思想，深入了解的话，可以看阮教授的这篇文章打开链接

function getSyncTime() {
  return new Promise((resolve, reject) => {
    try{
      let startTime = new Date().getTime();
      setTimeout(() => {
        let endTime = new Date().getTime();
        let data = endTime - startTime;
        resolve(data);
      }, 500);
    } catch (err) {
      reject(err);
    }
  });
}

async function getSyncData() {
  let time = await getSyncTime();
  let data = `endTime - startTime = ${time}`;
  return data;
}

async function getData() {
  let data = await getSyncData();
  console.log(data);
}

getData();

执行结果如下：

async/await

---