帶你快速入門koa：koa-router路由系統

一、自己手寫實作簡單的koa路由系統

koa本身是一個高級應用框架之下的框架，所以很多東西都是精簡的，需要我們自己根據需要引入插件，本身是沒有路由系統的，本身要做路由引導，可以簡單的做邏輯處理，

需要回傳什么給客戶端，直接傳給ctx.body就可以，koa自動幫我們做了序列化操作，

二、koa-router插件，三步實作簡單的路由

Koa-router:https://github.com/ZijianHe/koa-router

var Koa = require('koa');
var Router = require('koa-router');

// 第一步：實體化koa-router
var app = new Koa();
var router = new Router();

// 第二步：給koa-router物件添加路由和對應的處理函式
router.get('/', (ctx, next) => {
  // 后面會把這個函式注冊成中間件，所以這里放心使用ctx和next
  // ctx.router available
});

// 第三步：將koa-router物件的所有路由和處理函式注冊成為中間件
app
  .use(router.routes())
  .use(router.allowedMethods());

三、常見型別請求的處理

//根據需要修改
router
  .get('/', (ctx, next) => {
    ctx.body = 'Hello World!';
  })
  .post('/users', (ctx, next) => {
    // ...
  })
  .put('/users/:id', (ctx, next) => {
    // ...
  })
  .del('/users/:id', (ctx, next) => {
    // ...
  })
  .all('/users/:id', (ctx, next) => {
    // ...
  });

四、router中的引數傳遞方式

（1）地址query

路由：/users

地址：localhost:4000/users?q=1

取值：ctx.query

結果：{ q: 1 }

（2）獲取router params

路由：/users/:id

地址：localhost:4000/users/1

取值方式：ctx.params

結果：{ id: 1}

（3）請求體body

路由：/users

地址：localhost:4000/users，content-type為application/json，引數{“name”: “zj”}

取值：
先提前安裝 koa-bodyparser：
const bodyParser = require(“koa-bodyparser”);
app.use(bodyParser());
再：ctx.request.body

結果：{ “name”: “zj” }

五、將api router抽離到單獨檔案

入口代碼匯入抽離邏輯代碼，上層代碼匯入下層代碼

五、將api router抽離到單獨檔案

入口代碼匯入抽離邏輯代碼，上層代碼匯入下層代碼

// demo/api/api1.js

const Router = require("koa-router");

const router = new Router();

router.get("/api1", async (ctx, next) => {
  ctx.body = "api1";
});

module.exports = router;

// demo/app.js

const Koa = require("koa");
const api1 = require("./api/api1");
const api2 = require("./api/api2");

const app = new Koa();
const port = 3000;

app.use(api1.routes()).use(api1.allowedMethods());
app.use(api2.routes()).use(api2.allowedMethods());

app.listen(3000);
console.log("程式已經啟動，在" + port + "埠監聽");

六、router.prefix()將路徑中公共的部分先抽離出來

const router = require('koa-router')()

router.prefix('/users')

router.get('/', function (ctx, next) {
  ctx.body = 'this is a users response!'
})

router.get('/bar', function (ctx, next) {
  ctx.body = 'this is a users/bar response'
})

module.exports = router

七、requireDirectory實作路由自動加載

思路：

1.自動去尋找檔案夾中的api檔案 require進來

2.router require進來以后，自動注冊到app中

實作：requireDirectory
https://www.npmjs.com/package/require-directory

簡單用法：

const Koa = require("koa");
const Router = require("koa-router");

//requireDirectory是一個直接匯出的方法
const requireDirectory = require("require-directory");
//requireDirectory方法執行之后會回傳一個全部路由的物件
const routers = requireDirectory(module, "./api");

const app = new Koa();
const port = 3000;

// 通過便利把每一個router注冊到appshang
for (let routerName in routers) {
  if (routers[routerName] instanceof Router)
    app.use(routers[routerName].routes()).use(routers[routerName].allowedMethods());
}

app.listen(port);
console.log("程式已經啟動，在" + port + "埠監聽");

高級用法

const Koa = require("koa");
const Router = require("koa-router");
const app = new Koa();
const port = 3000;

function whenLoadModule(router) {
  if (router instanceof Router)
    app.use(router.routes()).use(router.allowedMethods());
}

//requireDirectory是一個直接匯出的方法
const requireDirectory = require("require-directory");
//requireDirectory方法也支持opitons引數，配置回應的回呼函式
requireDirectory(module, "./api", { visit: whenLoadModule });

app.listen(port);
console.log("程式已經啟動，在" + port + "埠監聽");

少抱怨，多思考，持續努力，必有識訓，