如何从 javadocs 生成 Swagger UI？

Question

我可以从@Api @ApiOperation,@ApiResponses注释在我的 Spring 启动应用程序上生成 swagger UI 。

这些注释使代码有点脏。我想知道如何从 javadocs 为我的 API 端点生成 swagger 文档。

Answer 1

简短的回答-不，不是真的。

更长的答案： Swagger 文件包含比代码更多的信息 - 例如您已经提到的@ApiOperation。我建议坚持使用我假设您已经使用过的 Swagger Maven 插件。我们的团队尝试自动生成客户端，以针对生成的 swagger 文件运行 API 测试，到目前为止，spring-fox 和其他解决方案还无法接近 swagger-maven-plugin 或手动编码文件。