【问题标题】:Swagger Version for Spring 3 and Spring 4Spring 3 和 Spring 4 的 Swagger 版本
【发布时间】:2015-11-04 09:54:24
【问题描述】:

我想用 Swagger 和 Spring MVC 记录一个 REST API,

我发现 Spring 3 只能使用 Swagger V1

        <artifactId>swagger-springmvc</artifactId>
        <version>1.0.2</version>

当我在@RequestBody 前面添加@ApiParam 时,在Data Type 中不完全显示。

最后我在 Spring 4 中选择了 Swagger V2

我添加了一些依赖和更改,如下所示。

        <artifactId>springfox-swagger2</artifactId>
        <version>2.2.2</version>
        <artifactId>spring-web</artifactId>
        <artifactId>4.1.6.RELEASE</artifactId>

现在可以在需要时显示任何 API 信息,

  1. 但仍然不知道为什么 Spring 3 只能使用 SwaggerV1

  2. 与Spring 3 & 4在使用Swagger V2时的区别

  3. 为什么 Spring 3 不需要 spring-web,但 Spring 4 需要

如果需要任何信息,请告诉我

如果您能提供任何帮助,我将不胜感激。

【问题讨论】:

    标签: java spring spring-mvc swagger springfox


    【解决方案1】:

    免责声明:SpringFox 不是产品,而是一个 OSS 项目。我是该项目的维护者之一,也是目前唯一活跃的维护者。

    说了这么多,让我来回答你的一些问题。

    但仍然不知道为什么 Spring 3 只能使用 SwaggerV1

    作为一项政策,当前积极维护的版本是 spring 最新版本的一个小版本。 Swagger v1 已经很老了,所以当 swagger 2 发布时,我们积极迁移到更新版本的 spring,最后一个支持 spring 3 的版本是1.0.2。这遵循 spring-hateoas 等 Spring 项目遵循的相同准则。

    以及使用 Swagger V2 时 Spring 3 和 4 的区别

    不同之处在于 spring 3 并不是真正支持 springfox v2.x 的版本。 spring 官方测试版是4.1.7.RELEASE for v2.2.2。

    为什么 Spring 3 不需要 spring-web,但 Spring 4 需要

    这是因为我们spring是springfox的provided dependency。因此库的使用者可以提供任何版本&gt; 4.1,并且该库可以正常工作。在 spring 3 中情况并非如此,因为我们发布了带有 spring 依赖项的 springfox 库。

    【讨论】:

      猜你喜欢
      • 2019-10-08
      • 2023-02-04
      • 2023-03-17
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2017-12-28
      • 2021-04-01
      • 1970-01-01
      相关资源
      最近更新 更多