swagger3.0使用及https问题处理
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了swagger3.0使用及https问题处理相关的知识,希望对你有一定的参考价值。
参考技术Aswagger 文档在日常开发中,用得比较多,往往我们都是手动配置,swagger3.0之后,直接就上了一个swagger-starter,用起来更方便了。swagger3.0发生了很多变化,比如包名、注解、访问路径等都有所变化。具体自己去体会了,我就是不多说了,直接开干。
swagger3.0项目地址: https://github.com/springfox/springfox
1.一个springboot项目
2.swagger3.0依赖
1.在springboot项目pom中添加入swagger3.0依赖
2.在启动类上加新版注解@EnableOpenApi
3.添加一个接口测试controller:
4.直接启动搞定: 注意 访问路径 http://localhost:8080/swagger-ui/index.html ,和2不一样了。
再一运行:
ok了,就搞定了。
当使用https后界面上的services地址不会随着你的项目域名变https时自动变https,如下图:
当然,这个bug官方会在3.0.1版本中修复, https://github.com/springfox/springfox/issues/3468 ,目前也是可以解决这个问题的,自定义swagger拦截器,借鉴了 https://github.com/springfox/springfox/issues/3531 ,
此时再重新启动项目:
就可以正常了,当然这只是我自己处理的一个思路,具体实现可以各抒己见。
最后的最后:demo地址: https://gitee.com/zzj1992/swagger3-demo.git
以上是关于swagger3.0使用及https问题处理的主要内容,如果未能解决你的问题,请参考以下文章
重学Spring系列之Swagger2.0和Swagger3.0