如何从javadoc生成Swagger UI？

Question

我可以通过

@Api

@ApiOperation

、

@ApiResponses

注释在我的 Spring boot 应用程序上生成 swagger UI。

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

Answer 1

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

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