Koa - 初体验（写个接口）

前言

　　不会node.js的前端不是一个好前端！

　　这几年node.js确实是越来越火了，好多公司对node.js都开始有要求。虽说前端不一定要会后端，但想要成为一个优秀的前端，node.js是必经之路。

　　我对于node.js的第一印象，认为它是一门后端语言，只是前端学习起来成本会更低更好上手。慢慢经过了解后，使用node.js写接口对于前端来说很方便，但不仅限于写接口。在一些大公司里，node.js并不是开发接口的首选目标，而是作为中间层来使用。我们都知道分工合作，让专业的人做更专业的事，工作效率会大大提高。node.js作为中间层的存在，可以让后端更专注于写接口和管理数据。

　　试想一下，现在由于业务逻辑改变，后端需要对数据接口进行更改，是否会花费时间？如果你会node.js，那么你就可以通过node.js来做数据聚合，从几个接口中拼接数据供前端使用，而不需要为数据结构和数据内容烦恼，并且你不用担心效率，因为node.js天生异步。

　　包括我们常用的一些脚手架工具也是基于node.js环境搭建，你甚至还可以使用node.js来做数据挖掘，也就是我们所说的爬虫，node.js的应用层面还有很多。以上都是我了解到的一些信息。

　　目前node.js比较主流框架分为express、koa、egg。koa作为新一代的框架，由开发express的原班人马打造，支持ES7 async/await，抛弃回调函数，在写法上更自然。koa没有绑定任何中间件，关键的设计点是在其低级中间件层中提供高级“语法糖”，koa的体积也因此更小。（中间件在koa中是一个很重要的存在，在后面我会着重去学习它）

　　接下来，我要开始koa入坑之路。

koa初体验

hello,koa！

创建一个app.js，命令行执行 node app

const Koa = require('koa' ); const app = new Koa();  app.context.msg = 'Hello Koa!'  app.use(async ctx => {   ctx.body = ctx.msg; });  app.listen( 3000);

为执行上下文添加属性和方法　　

将给定的中间件方法添加到应用程序中

该方法接收ctx和next作为参数，是执行上下文，里面存储了request和response等信息，还有ctx.body，我们可以通过它来返回数据，next作为函数调用，将执行权交给下一个中间件执行。

这里我先安装个nodemon，因为每次更改文件时，都需要重新执行命令以更新代码，这种重复性的工作就交给模块来处理。

通过 npm i nodemon 安装好后，命令行执行 nodemon app，这样每次更改文件时，nodemon都自动刷新。

Koa-router 路由管理

为了代码的可维护性，减少代码量。使用路由管理显得尤为重要，koa框架也有自己对应的路由管理模块（koa-router），我们可以通过npm 下载使用。

var Koa = require('koa' ); var Router = require('koa-router' );   var app = new Koa(); var router = new Router();   router.get( '/', (ctx, next) => {       ctx.body = 'hello' }); //使用路由中间件 app   .use(router.routes())   .use(router.allowedMethods());  app.listen( 3000 )

routes 注册使用路由

头，不加问题也不大，官方例子有加上，所以我这里也加了

这时访问3000端口就可以得到ctx.body 返回的内容

get请求

1. 获取接口query参数

通过查询 ctx.request.query 得到get参数， ctx.request.header 得到请求时的头部信息，ctx.request.method 得到请求方法。这样可以对应的来做一些判断，例如请求的参数是否合法，请求方法是否合法。

router.get( '/get', (ctx, next) => {       let id = ctx.request.query.id       ctx.body = {            id,            code: 1       } });

router.get( '/get/:id', (ctx, next) => {       let id = ctx.request.params.id       ctx.body = {            id,            code: 1       } });

例如请求地址为 /get/123，通过 ctx.request.params 获取参数

这写法让我想起了vue-router，设置params可以说是一样了。

post请求

原生获取post请求的参数，需要监听ctx.req的data事件和end事件，分段拼接成完整的字符串，然后还需要切割转码。所以在获取post参数时，我会借助 koa-bodyparser 来减少不必要的操作。

在引入 koa-bodyparser 时，需要注意的是顺序问题，使用 koa-bodyparser 需要放在使用路由之前，这是由于中间件执行顺序的原因（暂且理解为 bodyparser 经过处理，把处理好的值转交到路由）

var bodyParser = require('koa-bodyparser');  app.use(bodyParser());  app     .use(passport.initialize())     .use(passport.session())

借助中间件koa-bodyparser，访问 ctx.request.body 得到post参数

通过 ctx.set 设置返回头，设置多个时可传入对象

router.post('/post', ctx=>{　　　//设置允许跨域　　 ctx.set('Access-Control-Allow-Origin'，'*')     ctx.body = {         code:1,         postParams:ctx.request.body     } })

路由模块化管理

试想一下，现在文件中写有多个接口，我们在开发和调试起来都会特别麻烦，浪费时间。为了更好的管理接口，现在需要把接口按照功能抽离出来，封装到一个个的JS文件中，并存放到routes文件夹下。

例如，创建 user.js 来存放用户相关的接口

const Router = require('koa-router') const route = new Router() const jwt = require('jsonwebtoken')  route.get('/getToken', async (ctx)=>{     let {name,id} = ctx.query     if(!name && !id){         ctx.body = {             msg:'不合法',             code:0         }         return     }     //生成token     let token = jwt.sign({name,id},'secret',{ expiresIn: '1h' })     ctx.body = {         token: token,         code:1     } })  route.get('/getUser', async ctx=>{     let id = ctx.query.id     ctx.body = {         user:ctx.payload,         id,         code:1     } })  route.get('/getAllUser', async ctx=>{     let type = ctx.query.type     if(type){         ctx.body = {             type,             code:1         }     }else{         ctx.body = {             msg:'缺少参数type',             code:0         }     } })  module.exports = route

以上代码，将写好的接口暴露出去，供app.js注册使用

app.js代码（部分代码省略）

let urls = fs.readdirSync(__dirname + '/routes') urls.forEach((element) => {     //routes里的js接口文件     let module = require(__dirname + '/routes/' + element)     //routes里的文件名作为 路由名     router.use('/' + element.replace('.js', ''), module.routes()) })  //使用路由 app.use(router.routes()).use(router.allowedMethods())  app.listen(3000)

以上代码，我大概讲下流程

1. fs文件模块读取routes文件夹目录内容（获得的是一个文件名的数组）

2. 数组遍历，引入接口文件，将文件名作为路由名，注册使用路由

将 user.js 作为例子，user.js 内有一个 getUser 的接口，我访问的api地址为 /user/getUser

头部信息处理

在前后端交互中，头部信息也是很关键的一步，通过对头部信息的配置，可以对请求作出一些限制，或者是一些优化。

这里我会使用 koa2-cors 为例子，来对跨域做cors处理（部分代码省略）。

const cors = require('koa2-cors')  app.use(cors({     origin: function(ctx) {       return 'http://127.0.0.1:5500';//cors     },     exposeHeaders: ['WWW-Authenticate', 'Server-Authorization'],     maxAge: 5,     credentials: true,     allowMethods: ['GET', 'POST'],     allowHeaders: ['Content-Type', 'Authorization', 'Accept'], }))  app.use(router.routes()).use(router.allowedMethods())  app.listen(3000)