java - 配置Swagger-ui路径

Question

我使用 yml 文件和 quarkus 从下面的上下文配置 swagger-ui 路径

swagger-ui:
path: /clinic/swagger-ui

但是当启动我的应用程序并访问 swagger 时，看不到页面 swagger-ui 并如下更改配置，当我将其更改回上述配置时，我可以看到页面 swagger-ui 我可以看到 swagger-用户界面。

swagger-ui:
path: /swagger-ui

我这样做并且它在本地执行期间工作，如果它停止并重新启动我的应用程序我必须重做我上面描述的相同步骤。我不需要这个的任何解决方案吗？因为我有一个必须遵循的规则，其余路由和端点的其余部分必须在/clinic 内，如下所示

/clinic/swagger-ui -> page swagger

/clinic/api/ -> endpoints rest's

Answer 1

这在 Quarkus guide for OpenAPI and Swagger UI 之后起作用.为了重现，我做了以下事情:

1. 使用以下扩展创建一个 Quarkus (1.8.1) 项目:
   • quarkus-smallrye-openapi
   • quarkus-config-yaml(用于您的application.yml)
   • quarkus-resteasy(用于编程 REST 服务)
   • quarkus-resteasy-jsonb
2. 创建您的 REST 端点(我刚刚做了上述指南中的 /fruits 示例)
3. 配置application.yml

quarkus:
    smallrye-openapi:
        path: /fruit/openapi
    swagger-ui:
        path: /fruit/swagger-ui
        always-include: true

现在您可以通过 curl http://localhost:8080/fruit/openapi 访问 OpenAPI yml，通过将浏览器指向 http://localhost:8080/来访问 Swagger UI fruit/swagger-ui.

请注意设置always-include: true 使 Swagger UI 即使在生产中也可用!