2015-11-04 31 views
0

我想记录与扬鞭和Spring MVC一个REST API,扬鞭版本为Spring 3和弹簧4

而且我发现,春季3只能用扬鞭V1

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

当我添加@RequestBody前面的@ApiParam,不完全显示在数据类型中。

最后我选择扬鞭V2在春季4

我添加一些依赖和变化,如下图所示。

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

现在可以显示,当我需要的任何API信息,

  1. 但还是不知道为什么春天3只能使用SwaggerV1

  2. 和弹簧之间的差额3 & 4使用Swagger V2的时候

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

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

我会任何帮助,您可以提供感激。

回答

2

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

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

但还是不知道为什么春天3只能使用SwaggerV1

作为一项政策,当前积极维护版本的背后是春天的最新版本的一个次要版本。 Swagger v1相当陈旧,所以当swagger 2发布时,我们主动转向更新版本的spring,最后一个支持spring 3的版本是1.0.2。这跟随着像spring-hateoas这样的春季项目遵循的相同指导方针。

和Spring的区别3 & 4时使用扬鞭V2

不同的是,弹簧3是不是一个真正的支持版本springfox v2.x.正式测试版的弹簧是4.1.7.RELEASE,适用于v2.2.2

为什么春天3不需要弹簧网,但弹簧4需要

这是因为我们春天是springfox的provided dependency。因此,图书馆消费者可以提供任何版本> 4.1,图书馆将工作。春天3的情况并非如此,因为我们发布了具有spring依赖关系的springfox库。