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！

安装koa ，npm i 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);

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

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

该方法接收ctx和next作为参数，ctx 是执行上下文，里面存储了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 注册使用路由

allowedMethods 处理的业务是当所有路由中间件执行完成之后，若 ctx.status 为空或者404的时候，丰富 response 对象的 header 头，不加问题也不大，官方例子有加上，所以我这里也加了

这时访问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
      }
});

 

2. 命名路由  获取参数

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)

origin ： 接受字符串和函数，这里配置的就是允许跨域的域名，如果允许所有域名跨域可传入 *

allowMethods ： 允许请求的方式

allowHeaders ： 允许接受的头部信息

其他的配置选项可以在npm上查看：https://www.npmjs.com/package/koa2-cors

 

写在最后

本文通过路由中间件简单实现接口，模块化管理接口文件，还对接口进行跨域处理。

主要还是玩模块，通过模块可以组合出适合自己业务的系统。