Swagger界面丑、功能弱怎么破?用knife4j增强下就给力了!

281 阅读2分钟

在做 CRMEB-JAVA开源商城系统时,我们团队用到了uni-app,也是时下比较流行的移动端开发技术,这里边就牵扯到了前后端全部分离的问题,一般在使用java开发前后端分离项目的时候,都会用到Swagger,Swagger 是一个用于生成、描述、调用和可视化 RESTful 风格的 Web api 服务的框架,Swagger 让部署管理和使用功能强大的 API变的简单,但这仅仅是在小型项目里,API接口不多的情况下。

    随着,CRMEB-JAVA开源商城系统的不断优化,功能的不断增加,并且前后台都做到了前后端分离,接口数量一度超过了200多个,这就使得系统中一些使用体验变的越来越差,例如:提交参数为JSON没法格式化,参数错了查找麻烦,返回结果没法折叠,太长了没法看,真是非常的痛苦呀!

   但是,作为程序员一定要知道,你遇到的问题别人也一定遇到过,也肯定有热心的大牛解决了这个问题,所以,一个叫knife4j的增强版本Swagger诞生了,他帮我们很好的解决了以上问题,引用一下原作者的话来简单了解下knife4j:

希望knife4j像一把匕首一样小巧,轻量,并且功能强悍,也希望把她做成一个为Swagger接口文档服务的通用性解决方案,而不仅仅只是专注于前端Ui前端. 先上一张项目刚上的knife4j优化过的Swagger的剧照,先睹为快:

看上图是不是一目了然,最重要的是搜索框可以搜索相关api接口快速查询,并且可以在线调试接口,再来张图展示!

CRMEB_java开源商城 v1.2.1今天将会发布 更新列表 1. 短信后台升级,更新供应商 2. 替换官方swagger文档为kinfe4=>doc.xiaominfo.com/knife4j 3. 添加商品分类必要素材,可在配置好图片服务后自行维护

源码免费下载地址:github.crmeb.net/u/defu

大家不要吝啬发财的小手,给项目点个Start哦,感谢老铁们了!