Spring Mvc和SpringBoot整合Swagger2


各位同学大家好,最近项目赶进度,没有钻研技术的时间,但碰巧今天需要在Spring项目上进行SpringMvc和Swagger的整合,而第一次使用Swagger是在SpringBoot项目上,因此踩了不少的坑,于是想和大家分享一下
:关于Swagger在SpringBoot或者和SpringMvc的集成!


随着开发模式逐渐向前后端分离演变,沟通的成本逐渐增加,前端和后端的唯一联系,变成了API接口;API文档变成了前后端开发人员联系的纽带,变得越来越重要,swagger就是一款让你更好的书写API文档的框架。

没有API文档工具之前,大家都是手写API文档的,在什么地方书写的都有,有在confluence上写的,有在对应的项目目录下readme.md上写的,每个公司都有每个公司的玩法,无所谓好坏。
书写API文档的工具有很多,但是能称之为“框架”的,估计也只有swagger了。
这里写图片描述

下面再细看看swagger的生态的具体内容:
1. swagger-ui
这玩意儿从名字就能看出来,用来显示API文档的。和rap不同的是,它不可以编辑。
2. swagger-editor
就是一个在线编辑文档说明文件(swagger.json或swagger.yaml文件)的工具,以方便生态中的其他小工具(swagger-ui)等使用。
3. swagger-validator
这个小工具是用来校验生成的文档说明文件是否符合语法规定的。
4. swagger-codegen
代码生成器,脚手架。可以根据swagger.json或者swagger.yml文件生成指定的计算机语言指定框架的代码。
有一定用处,Java系用的挺多。工业上应该不咋用。

 

swagger现在有两个版本,同时对应两种集成方式;版本1的swagger需要下载swagger-ui项目并导入自己的项目,导致项目臃肿且现在已不支持使用;因此我们现在的集成是对swagger2而言;首先,英文名男我们先讲解SpringBoot项目下的集成。

 

这里写图片描述

这里写图片描述

 

 

这里写图片描述


好了,做到这,关于swagger的集成算是完成了!有空也可以去研究一下swagger的其他用法,毕竟它还是能提高我们的开发效率。

猜你喜欢

转载自www.cnblogs.com/zhaolide/p/9946883.html