转载

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

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

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

3.浏览测试结果

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

接口文档Swagger

1.了解 swagger

这个hapi插件是笔者认为强大好用的工具,可以根据路由给的config配置,自己生成对应的接口文档、测试接口数据 以及 配合Joi插件来校验数据

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插件

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

5.访问接口文档

访问地址: http://localhost:3000/documentation

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

6.路由配置生产测试接口

修改测试路由文件 ./routes/test.js

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

再次访问文档地址

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

原文  https://segmentfault.com/a/1190000019014961
正文到此结束
Loading...