Koa系列-Documentation:koa-joi-swagger
2018-12-14
字数统计:351 字
阅读时长 ≈ 1 分钟
这个中间件主要是用来搭建 api 文档管理的网站,用到了 swagger-ui
作为页面 UI, joi
用做管理 js 对象的验证器。
首先是用 joi.extend
扩展了对象,字符和数字新的 joi 实例。
然后选择是用 v3 还是 v2 的 swagger-ui
,得到最终渲染的模板 html。
最后对描述 api 的内容进行转化,生成验证规则,得到最终的 api 文档管理。
这个中间件挺老了,并且用法也不太方便,而且现在市面上也出现了挺多优秀的 api 文档管理系统。
所以就大概就了解其实现思路。