Swagger 是开发中最常用的框架之一了,但 Swagger 本身又有很多不完善的地方,比如,在众多的接口中查询某一个接口,又或者是把所有的接口导出成 Word 格式等,都无法在 Swagger 中实现。
有人可能会问:为什么要把接口导成 Word 格式?这种场景还挺常见的,比如需要将接口对外部公司开放时,又或者是开发环境的网络不能对外部开放(如专线,很多医院都拉的是专线),而生产环境的 Swagger 又是关闭状态的时候,这时候只能依赖离线文档来实现接口的调用了,而离线文档最常用的格式便是 Word 了。
那么为了解决 Swagger 的这些问题,我们需要使用一个 Swagger 的增强工具来实现,而这个扩展工具就是我们今天要重点介绍的 Knife4j,那 Knife4j 长得是什么样呢?我们一起来看,如下图所示:
从这个主页可以看出,Knife4j 会将 Swagger 中设置的摘要信息(Docket)显示在欢迎页,Docket 的设置可以看我之前的文章,并且 Knife4j 还很贴心的提供了一个统计所有接口的功能,在欢迎页的最下方我们可以很清楚的看到当前 POST 接口的数量,以及 GET 的接口的数量。
PS:Knife4j 支持中文和英文两种语言展示,对于国内的小伙伴来说,可读性非常的高(因为都是中文的嘛)。
Knife4j 功能介绍
1.搜索功能
我觉得 Knife4j 最实用的一个功能就是“接口搜索”了,通过这个功能我们可以非常方便的找到我们需要的接口,如下图所示: