swagger - 如何使用响应式路由在 Quarkus 中启用 swagger iu？

Question

我正在使用 Quarkus 构建一个项目，并且我决定使用Reactive Routes。

我想将 OpenAPI 信息和 Swagger UI 添加到我的项目中。使用RestEasy似乎可以做到这一点，但我没有找到与 Reactive Routes 相同的信息。

那可能吗？我试图启用它，但我不能。

标签： swaggerswagger-uivert.xopenapiquarkus

Answer 1

这真的不可能。

RESTeasy 方法依赖于反射和注释的组合来确定 REST 接口是什么。使用 Vert.x Web 路由时，您可以获得更大的灵活性，因为该级别的信息无法以标准方式获得。

有几种选择：

• 预先编写 OpenAPI 定义并使用它来生成路由（https://how-to.vertx.io/web-and-openapi-howto/）
• 查找（或编写）一个约束您的 Vert.x 代码的生成器，以便它可以动态确定合约（https://jitpack.io/p/ckaratzas/vertx-openapi-spec-generator是一个示例，它可能不是唯一的）。

如果我需要生成 OpenApi 文档，我个人会使用 RESTeasy。