魔改swagger,knife4j 的另外一种打开方式(四)

303 阅读2分钟

「这是我参与2022首次更文挑战的第19天,活动详情查看:2022首次更文挑战」。

哈喽大家好,我是阿Q!

上文我们从实战角度讲解了“魔改swagger,knife4j 的另外一种打开方式”,本文我们再来进行一下扩展,讲一下“其它问题”!

公益地址问题

还有swagger注册中心地址

服务名字域名访问地址
nacos地址nacos.kdyzm.cnnacos.kdyzm.cn/nacos (不提供管理端账号密码)
eureka地址eureka.kdyzm.cneureka.kdyzm.cn (无需账号密码访问)
swagger注册中心地址swagger.kdyzm.cnswagger.kdyzm.cn/doc.html (无需账号密码访问)

由于受限于资源和网络带宽,访问速度会比较慢;请善待公共资源,不要对它们进行压测和其它非正常操作。

模式切换

配置文件中有个配置项:swagger.config.server-url ,若该配置项不为空,则走直连模式,即不通过服务发现直接请求该server-url上传swagger文档;

如果未配置该配置项,则检查swagger.config.service-id字段,如果该字段也没有配置值,则报错并跳过swagger文档上传。

配置唯一性

为了能在分组里唯一区分,必须要将appNamename保持唯一,而且现在上传文档之后不支持删除,如果误上传到了swagger.kdyzm.cn,发邮件给我我来删除,我的邮箱地址:kdyzm@foxmail.com

源代码

原本分了两个单独的项目,维护起来不是很方便

项目名称项目地址
swagger-register-servergitee.com/kdyzm/swagg…
swagger-spring-boot-startergitee.com/kdyzm/swagg…

所以现在再加上实战案例放到同一个项目中进行管理。

三合一项目地址:

项目地址
gitee地址gitee.com/kdyzm/swagg…
github地址github.com/kdyzm/swagg…

以后的更新均会放到该项目中进行。

题外篇

阿Q将持续更新java实战方面的文章,感兴趣的可以关注下公众号:阿Q说代码,也可以来技术群讨论问题呦,点赞之交值得深交!