Quarkus应用程序-将基本路径添加到OpenAPI定义

Question

我目前正在开发基于Quarkus的API，该API将托管在API网关上，该网关要求我们的应用程序以基本路径运行，我通过设置Quarkus发现了这一点。放松。应用程序中的路径。属性我可以使用基本路径运行应用程序，并且它将自动添加到规范中。

我正在使用org生成一个OpenAPI 3规范。日食微文件。openapi。注释。我的问题是，在规范中，这个基本路径被添加到每个操作中。相反，我试图只在服务器声明中应用基本路径，这与OpenAPI 2.0中使用的基本路径类似。

当前结果：

servers:
- url: https://dev.example.com
  description: Development
- url: https://example.com
  description: Production
security:
- jwt: []
paths:
  /api/capacity/availability:
    get:
      ...
  /api/capacity/consume:
    post:
      ...

预期结果：

servers:
- url: https://dev.example.com/api
  description: Development
- url: https://example.com/api
  description: Production
security:
- jwt: []
paths:
  /capacity/availability:
    get:
      ...
  /capacity/consume:
    post:
      ...

任何帮助将不胜感激。

Answer 1

您还可以使用config设置服务器：quarkus。smallrye openapi。服务器

看https://quarkus.io/guides/openapi-swaggerui#quarkus-smallrye-openapi_quarkus.smallrye-openapi.servers