如何从javadocs生成Swagger UI?

10

我可以通过使用@Api@ApiOperation@ApiResponses注解在我的Spring Boot应用程序上生成Swagger UI。

这些注解会使代码有点混乱。我想知道如何从Javadocs生成我的API端点的Swagger文档。


什么是javadoc的意思? 我知道javadoc,但我不明白你是如何使用javadoc来生成swagger/openapi规范的。 - undefined
你可以参考下面的回答 @user2244399 - undefined
3
@petet 我的意思是根据每个控制器方法上方的注释生成代码。 - undefined
1
相关:使用Javadocs生成Swagger文档 - undefined
这个回答解决了你的问题吗?使用Javadocs生成Swagger文档 - undefined
1个回答

0

简短回答 - 不,实际上并不是。

更详细的回答:Swagger文件包含的信息远远超过了代码 - 例如你已经提到的@ApiOperation。 我建议你继续使用Swagger Maven插件,我假设你已经在使用了。我们团队尝试过自动生成客户端来运行针对生成的Swagger文件的API测试,到目前为止,spring-fox和其他解决方案都无法与swagger-maven-plugin或手动编写文件相媲美。


网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接