使用 Spring REST Docs 生成 Swagger 客户端

Question

我看过这个 Spring REST Docs -视频

我们正在做的春天启动的项目和使用springfox库所概述产生扬鞭的UI和招摇文档在这里

我们喜欢 Spring Rest 文档可以为生成 REST API 文档所做的事情，以及我们不必在控制器代码中添加像 @ApiResponse 或 @ApiOperation 这样的大摇大摆的注释这一事实。 以及文档现在与代码一起存在的事实。

但是如果使用 Spring Rest 文档，我们将错过为我们的 API 自动生成的 Swagger-UI（当我们使用 swagger 集成时）。

Spring REST 文档是否可以生成像 Swagger UI 这样的测试 UI。

Answer 1

这直接违背了 Spring REST Docs 的设计思想和意图。 它的主要目标之一是将文档与单元测试相关联，因此即使您在 REST 合同中进行逻辑或签名更改，您也知道您的文档坚如磐石。

此外，您链接到的视频提供了许多示例，说明自动化文档生成如何产生大量不需要的意外输出。

因此，它可以选择做更多的工作来获得更好的文档，或者选择完全自动化的选项来节省时间并获得可行但质量较低的文档。 这是您的首要任务。

Answer 2

该项目从 Spring REST Docs 生成 OpenAPI 规范。

https://github.com/ePages-de/restdocs-api-spec