【发布时间】:2019-04-14 00:55:10
【问题描述】:
有 Swagger 2 规范的 Springfox 实现和 Swagger Maven Plugin。他们之间有什么区别?我什么时候应该更喜欢一个而不是另一个?
【问题讨论】:
标签: java spring-boot swagger swagger-ui springfox
有 Swagger 2 规范的 Springfox 实现和 Swagger Maven Plugin。他们之间有什么区别?我什么时候应该更喜欢一个而不是另一个?
【问题讨论】:
标签: java spring-boot swagger swagger-ui springfox
Swagger maven 插件从 Java 注释生成 swagger 规范。
Springfox 从 Java 注释生成一个完整的基于 Web 的 UI,其中包含文档、示例和功能来尝试操作。
【讨论】:
我看到的最明显的区别是 SpringFox 不需要您像 swagger-maven-plugin 那样手动 swagger-annotate 类。
第二个是swagger spec生成时间:
分别是编译时间和构建阶段。
SpringFox
无需任何手写文档,只需检查应用程序中的类,它就可以生成大量有关 API 的信息。
Swagger-maven-plugin
使您的 Swagger 注释项目能够在 Maven 构建阶段生成 Swagger 工件。它将规范生成为要在下游 Swagger 工具中使用的构建工件。
【讨论】: