我可以通过使用@Api
、@ApiOperation
和@ApiResponses
注解在我的Spring Boot应用程序上生成Swagger UI。
这些注解会使代码有点混乱。我想知道如何从Javadocs生成我的API端点的Swagger文档。
我可以通过使用@Api
、@ApiOperation
和@ApiResponses
注解在我的Spring Boot应用程序上生成Swagger UI。
这些注解会使代码有点混乱。我想知道如何从Javadocs生成我的API端点的Swagger文档。
简短回答 - 不,实际上并不是。
更详细的回答:Swagger文件包含的信息远远超过了代码 - 例如你已经提到的@ApiOperation。 我建议你继续使用Swagger Maven插件,我假设你已经在使用了。我们团队尝试过自动生成客户端来运行针对生成的Swagger文件的API测试,到目前为止,spring-fox和其他解决方案都无法与swagger-maven-plugin或手动编写文件相媲美。