我在 Spring Boot
1.6.9
应用程序中使用 springdoc 2.6.7
,并已转而使用 YAML 文件来表示 API 规范,而不是注释。
我已按照官方文档 12.57 配置项目以使用 YAML 文件。设置 Swagger UI 以使用提供的 spec.yml 的正确方法是什么?并且使用
application.yaml
文件中的下一个配置对于两个 Api 组来说工作得非常好:
springdoc:
api-docs:
enabled: false
swagger-ui:
urls:
- name: API 1
url: /api-spec/api-1.yaml
- name: API 2
url: /api-spec/api-2.yaml
我唯一无法弄清楚的是是否可以神奇地填充规范的
server
部分,以便它指向我正在部署应用程序的环境。使用默认的 springdoc 设置,服务器将“自动”成为环境的 URL。请参阅使用带有注释的默认配置拍摄的下一个屏幕截图:
有没有办法配置 YAML 文件以像默认配置一样从当前部署主机中选择服务器 URL?
server
部分。
稍有缺点的是,服务器下拉列表在 Swagger UI 页面上不可见,但通过 UI 发出的所有调用都会命中 Swagger UI 页面所在的同一主机 - 因此,我当前正在浏览其 API 页面的应用程序的同一实例。