安装swagger过程及遇到问题
参考:欢迎点击原文:https://www.cnblogs.com/liconglong/p/11477401.html(主要)
https://blog.csdn.net/liangjiabao5555/article/details/107021911/
原来知道swagger会影响项目效率,想就忽略这个知识点的,没想到公司项目需要用到这个,没办法自己手动搞一个吧。
首先先普及下认知,swagger就是个接口平台,可以嵌入到项目中,这样就不用自己写接口文档了,而且各种版本都有,这边就以java为例展开
安装前端的swagger
- 过程忽略,百度很多,这边就说遇到的问题,安装是显示安装成功了,然后本地执行:
http-server -p 8000
,然后浏览器访问,命令框直接显示进程停止,报错:swagger TypeError: Readable.from is not a function
,百度了半天没结果,参考这位老哥的博客也是用mac安装的环境,执行下npm start
就可以了,这个命令百度了下说是安装所有这个前端项目中package.json里面的依赖,然后自动启动成功。 - 还有按照教程启动了个Swagger Ui,这个类似于定制你的页面我是这样理解的
srpingboot安装swagger
这个安装过程也是忽略,无非就是加pom依赖,编写config,controller上加swagger注解,主要遇到的问题有如下:
上图报错解决方式是原来我用的是swagger2.2.2,百度出来建议2.9.2就可以了
上图很明显说的guava19有冲突,百度出来换成20就行了。
总结: 按照流程安装是不难,但是这个途中会遇到各种意想不到的情况,这个才是考验人的地方,也不能光靠百度,自己总结尝试也是很重要的,对了maven冲突处理还是很薄弱,要改进。