hapi框架搭建记录(二)：路由改造和生成接口文档

摘要：框架，用官网的简介来说就是是构建应用程序和服务的丰富框架，它使开发人员能够专注于编写可重用的应用程序逻辑，而不是花时间构建基础设施。用自己的话简单来说，就是个类似，之类的服务基础框架。

</>复制代码 
hapi框架，用官网的简介来说就是：Hapi是构建应用程序和服务的丰富框架，它使开发人员能够专注于编写可重用的应用程序逻辑，而不是花时间构建基础设施。
用自己的话简单来说，就是个类似express，koa之类的node服务基础框架。
此篇博客是在阅读过掘金小册的《基于 hapi 的 Node.js 小程序后端开发实践指南》并实践操作后，以此记录实践过程和踩过的坑。感兴趣读者可支持阅读掘金小册原版的内容。

</>复制代码 
1. 在./routes目录下新建index.js
作为路由的汇总，这样以后只管在./routes下新建文件即可

</>复制代码 
"use strict";
const fs = require("fs");
const path = require("path");
const basename = path.basename(__filename); // 当前文件名
let routeArr = [];
// 同步读取当前目录，并过滤除了当前文件的文件名数组
fs.readdirSync(__dirname)
  .filter(file => {
    // 过滤掉隐藏文件、当前文件、非js文件, 返回当前目录下文件名称数组
    return (
      file.indexOf(".") !== 0 && file !== basename && file.slice(-3) === ".js"
    );
  })
  .forEach(file => {
    // 引入路由模块
    let arr = require(path.join(__dirname, file));
    // 汇总
    routeArr.push(...arr);
  });
module.exports = routeArr;

</>复制代码 
1.新建test.js文件作为测试

</>复制代码 
const GROUP_NAME = "test";
module.exports = [
    // 纯测试返回 接口
  {
    method: "GET",
    path: `/${GROUP_NAME}`,
    handler: (request, h) => {
      const data = { message: "test" };
      // 响应数据方式：
      // return h.response(data).code(200);
      return data;
    }
  },
]

</>复制代码 
2.修改app.js

</>复制代码 
3.浏览测试结果

</>复制代码 
1.了解swagger

</>复制代码 
2.安装swagger相关依赖

</>复制代码 
npm i hapi-swagger inert vision package

</>复制代码 
3.编写配置插件
</>复制代码 
在./plugins 目录下新建hapi-swagger.js
可参考官方示例

</>复制代码 
const hapiSwagger = require("hapi-swagger");
const inert = require("inert");
const vision = require("vision");
const package = require("package");
module.exports = [
  inert,
  vision,
  {
    plugin: hapiSwagger,
    options: {
      info: {
        title: "接口文档", // 文档的标题
        version: package.version // 文档的版本
      },
      // 定义接口以tags属性为分类【定义分类的大标题】,给./routes路由的配置config:tags使用
      grouping: "tags",
      // 标签，用于对应路由config定义的tags进行归类
      tags: [
        { name: "test", description: "测试相关" }
      ],
      lang: "zh-cn" // 文档语言
    }
  }
];

</>复制代码 
4.app.js入口文件配置swagger插件

</>复制代码 
5.访问接口文档
</>复制代码 
访问地址：http://localhost:3000/documentation

</>复制代码 
6.路由配置生产测试接口
</>复制代码 
修改测试路由文件 ./routes/test.js

</>复制代码 
再次访问文档地址