springdoc - 我们可以在 Springdoc 中用 redoc 替换 swagger-ui

Question

我正在尝试用 Springdoc 替换手动维护的 swagger 文件。目前，我们使用 ReDoc渲染文件，因为他们支持 discriminator .

是否有直接的方法来替换/取代嵌入式 swagger-ui与 ReDoc ?

Answer 1

在 springdoc 中，您可以跳过使用 swagger UI 包并使用:

    <dependency>
        <groupId>org.springdoc</groupId>
        <artifactId>springdoc-openapi-webmvc-core</artifactId>
    </dependency>

反而。然后您可以在 <redoc /> 中指向使用 springdoc 生成的 swagger 模式的位置(默认为/v3/api-docs)。零件。其余的取决于您托管 Redoc 的方式。在我们的例子中，我们只是在我们的服务/应用程序中添加了一个 Controller ，它提供了 Redoc 文档页面 ( https://github.com/Redocly/redoc#tldr) 中描述的基本 HTML。