swagger升级knife4j:一路上升级打怪
闲话说在前面
用过java做前后端分离的项目的老干部,基本上都受到过接口文档的折磨。
特别是CMMI的等级比较高的,公司流程比较长的。API文档的更新不及时和不完整,
一直是前端和后端的战争导火索。
swagger一出来后,基本上吵架少了很多。只要有一点项目经验的,多少都用过swagger。
为什么?
我们像来说下
Swagger是什么?有什么用?
官网:https://swagger.io/
如果你有那份闲心,你可以仔细琢磨琢磨下原文档。
按照通俗的话来说,Swagger的出现,极大的解放了程序员的双手。你可以不再去琢磨word文档的表格,字体大小....
你只要按照规范要求,给每个字段添加好对应的注释。
如果你想更加偷懒的话,可以下载一个人人代码生成器,它可以把注解和数据库的字段注释关联起来,生成一大片的机械代码。你至少需要简单修改下就可以了。
然后你配置好了后,启动了项目,把项目地址扔给前端小妹子。告诉她,在接口地址后面加上swagger-ui.html。你要的所有的接口的信息,都在上面了。
你只要写代码就好,剩下你不擅长的API文档,swagger就帮你包圆了
既然它这么好?为什么人们还要看着碗里,想着锅里的呢?
knife4j的出生
人都是一样的,见异思迁。有能用的,希望能有更好用的。
swagger是解放了后端的双手,但是生成的文档格式,样式:特别是那种绿,绿的发光;那种黑,黑的发慌。
在国人面前看来,还有点像洋大人的味道。有点水土不服。如果你用过外国人的app,再用国人的app。您就能深深体会那种感觉了。
knife4j就是在这样的场景下产生的。主要解决大家审美的问题。
一切以国人的方式来对页面样式进行了调整。
不信,你对比下样式就知道了。
swagger原生态:
knife4j :
是不是心情愉悦度有天壤之别?
升级之路
1、干掉所有的swagger-*相关的引用包。
knife4j已经把所有的包都帮你引入了,不需要你再单独引入。
重复的引入有可能会导致你的包冲突而报错
2、删除springfox-*相关的包
knife4j对应的包有对应的springfox的对应的版本。不要保留了
3、参照官网的快速开始。引入对应的knife4j包。
https://doc.xiaominfo.com/knife4j/documentation/get_start.html
打包,上传、启动项目,然后告诉前端妹子:哥哥能力提升了,请将地址从swagger-ui.html换成doc.html。
至此,已经全部完成。
总结
项目的提升和优化,是一个无尽之路。需要不断的提升自己的能力,然后在工作中不断的释放自己的小宇宙。
swagger升级knife4j:一路上升级打怪相关推荐
- mysql_upgrade 升级_采用MySQL_upgrade升级授权表方式升级
[[email protected] MySQL]# /usr/local/MySQL/bin/MySQL_upgrade Looking for 'MySQL' as: bin/MySQL Look ...
- linux deepin 20.4升级至20.5教程:升级系统和升级内核两个步骤(手动升级deepin内核命令)
升级系统版本 在控制中心点击更新就可以实现. 升级内核版本 在控制中心完成系统版本的升级之后,发现内核版本并没有进行同步升级,这时候就需要手动实现内核的升级.手动升级内核的命令如下: sudo apt ...
- mysql dump工具升级_MySQL数据库升级
当前不少系统的数据库依旧是MySQL5.6,由于MySQL5.7及MySQL8.0在性能及安全方面有着很大的提升,因此需要升级数据库.本文通过逻辑方式.物理方式原地升级来介绍MySQL5.6 升级至M ...
- Android 系统(144)---整包升级与差分升级的区别
整包升级与差分升级的区别 原文地址:FULL VS INCREMENTAL OTA 一.简介: OTA升级有两种类型,每一种类型都有对应的用途和优势.但是,只有一种类型是用户常常能够接触到的.现在我们 ...
- 4-STM32物联网开发WIFI(ESP8266)+GPRS(Air202)系统方案升级篇(远程升级WIFI内部程序)
https://www.cnblogs.com/yangfengwu/p/10360618.html 演示视频: https://www.bilibili.com/video/av54894356/ ...
- ubuntu14.04升级以及gitlab升级
环境:系统版本ubuntu14.04 .gitlab-ce.8.11.3 升级要求:系统升级为目前最新的LTS版本的ubuntu16.04.gitlab升级为最新的版本 升级可以有两种方案: 一种类似 ...
- Oracle 10g升级之--PSU 升级(续)
Oracle 10g升级之--PSU升级(续) 5.再从10.2.0.4.4 升级到10.2.0.4.11 -----------升级到10.2.0.4.11 [oracle@RH4 12879929 ...
- 电信物联网平台SOTA升级(软件升级)的全流程说明
中国电信物联网开放平台(以下简称"平台")提供了基于LWM2M的固件升级功能,用于模组的固件升级.但是由于多数模组并未提供升级接口给MCU,所以MCU升级只能基于应用层来实现升 ...
- rust墙壁升级点什么_明日之后屋子墙壁怎么升级?墙壁升级条件方法一览
明日之后屋子墙壁怎么升级?墙壁升级条件方法一览 2018-11-05 16:06 作者:佚名 来源:本站整理 浏览:4868 明日之后屋子墙壁怎么升级?在明日之后手游中,我们可以通过一些方法给自己屋子 ...
- rust建造一键升级_rust一键升级指令 | 手游网游页游攻略大全
发布时间:2017-05-29 1.9-1.10一键卧室家具指令 让你的卧室更舒适.那下面则是一个可以帮助玩家更快速的制作家具装饰自己卧室的一键命令方块指令哦~有感兴趣的玩家不妨进来看看下面的介绍吧! ...
最新文章
- 在html中不是链接目标属性,在HTML中,()不是链接的目标属性。
- [BZOJ]2563: 阿狸和桃子的游戏
- 使用Stream流的方式,遍历集合,对集合中的数据进行过滤
- oracle学习篇一:sqlplus常用命令
- Vue-在data中引入静态图片路径
- 我的成长日记20210406(日常测试工作安排)
- 图片没有.png或者jpg后缀能不能加载?
- http性能测试点滴
- rds对mysql优化_RDS MySQL优化方案
- 概率论 方差公式_2021考研数学概率论与数理统计常考内容
- Java项目--网页版音乐播放器(Spring Boot 后端逻辑)
- 串行通讯控制器8250
- 开源一个简单的android手机音乐app
- EChat(简易聊天项目)八、Socket实现即时通信(包括部分修改)
- java中使用javac编译时报错:未报告的异常 必须对其进行捕捉或声明以便抛出
- 遭遇Backdoor.Gpigeon.2007.ca,Trojan-PSW.Win32.QQRob.lg,Backdoor.Win32.Agent.bcn等3
- 深入理解Java虚拟机—Java虚拟机内存
- Linux - 常见端口和服务的对照和解释
- 第07课:使用 HTML 5 API 创建子窗口
- 爬虫配套学习-前端学习笔记04-表格