2015-11-04 46 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庫。