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


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

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

两个springboot项目jar包整合成一个 springboot怎么整合springmvc_json



下面再细看看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项目下的集成。




两个springboot项目jar包整合成一个 springboot怎么整合springmvc_json_02

两个springboot项目jar包整合成一个 springboot怎么整合springmvc_后端_03

 




两个springboot项目jar包整合成一个 springboot怎么整合springmvc_后端_04


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