Springfox Swagger 与 Swagger maven 插件

Springfox Swagger vs Swagger maven plugin

Springfox implementation of the Swagger 2 specification and Swagger Maven Plugin个。它们之间有什么区别?我应该在什么时候更喜欢一个?

Swagger maven 插件从 Java 注释生成 swagger 规范。

Springfox 从 Java 注释生成一个基于 Web 的完整 UI,带有文档、样本和功能来尝试这些操作。

我看到的最明显的区别是 SpringFox 不需要您像 swagger-maven-plugin 那样手动 swagger-annotate 类。

第二个是swagger规范生成时间:
分别是编译时间和构建阶段。

SpringFox
无需任何手写文档,只需在您的应用程序中检查 类,它就可以生成大量关于您的 API 的信息。

Swagger and SpringFox

Swagger-maven-plugin
使您的 Swagger 注释项目能够在 Maven 构建阶段生成 Swagger 工件。它生成规范作为构建工件,用于下游 Swagger 工具。

Swagger-Maven-Plugin