「这是我参与2022首次更文挑战的第19天,活动详情查看:2022首次更文挑战」。
哈喽大家好,我是阿Q!
上文我们从实战角度讲解了“魔改swagger,knife4j 的另外一种打开方式”,本文我们再来进行一下扩展,讲一下“其它问题”!
公益地址问题
还有swagger注册中心地址
| 服务名字 | 域名 | 访问地址 |
|---|---|---|
| nacos地址 | nacos.kdyzm.cn | nacos.kdyzm.cn/nacos (不提供管理端账号密码) |
| eureka地址 | eureka.kdyzm.cn | eureka.kdyzm.cn (无需账号密码访问) |
| swagger注册中心地址 | swagger.kdyzm.cn | swagger.kdyzm.cn/doc.html (无需账号密码访问) |
由于受限于资源和网络带宽,访问速度会比较慢;请善待公共资源,不要对它们进行压测和其它非正常操作。
模式切换
配置文件中有个配置项:swagger.config.server-url ,若该配置项不为空,则走直连模式,即不通过服务发现直接请求该server-url上传swagger文档;
如果未配置该配置项,则检查swagger.config.service-id字段,如果该字段也没有配置值,则报错并跳过swagger文档上传。
配置唯一性
为了能在分组里唯一区分,必须要将appName和name保持唯一,而且现在上传文档之后不支持删除,如果误上传到了swagger.kdyzm.cn,发邮件给我我来删除,我的邮箱地址:kdyzm@foxmail.com
源代码
原本分了两个单独的项目,维护起来不是很方便
| 项目名称 | 项目地址 |
|---|---|
| swagger-register-server | gitee.com/kdyzm/swagg… |
| swagger-spring-boot-starter | gitee.com/kdyzm/swagg… |
所以现在再加上实战案例放到同一个项目中进行管理。
三合一项目地址:
| 项目 | 地址 |
|---|---|
| gitee地址 | gitee.com/kdyzm/swagg… |
| github地址 | github.com/kdyzm/swagg… |
以后的更新均会放到该项目中进行。
题外篇
阿Q将持续更新
java实战方面的文章,感兴趣的可以关注下公众号:阿Q说代码,也可以来技术群讨论问题呦,点赞之交值得深交!