io.swagger.annotations和com.wordnik.swagger.annotations之间有什么不同

时间:2016-04-01 03:03:58

标签: swagger

我是swagger的新手,发现有两个swagger注释包:io.swagger.annotations和com.wordnik.swagger.annotations。我想知道他们和我应该使用的是什么区别?

3 个答案:

答案 0 :(得分:9)

com.wordnik包适用于较旧的swagger规范,1.x。从swagger规范2.0开始,包现在是io.swagger。注释签名应该相同,只是包已更改。

答案 1 :(得分:6)

这些是不同版本的swagger,它们与您可能正在使用的其他支持软件堆栈的不同版本一起使用。

一个月前,当我尝试将我的应用程序与swagger ui集成时,我也遇到过这两个问题。我使用的是cxf 2.7.11,jackson 2.6.0和spring 3.0.7。我使用com.wordnik(旧版本,在url api_docs中使用ApiListingResource等生成了swagger json)时遇到了很多困难,但后来考虑实现io.swagger(更新版本)只是为了看看差异。原来那是我应该首先使用的版本。之后一切都到位了。

答案 2 :(得分:0)

如果其他人也在想,还有一个补充:

我们使用了名为swagger-core_2.10的swagger版本1.3.13。最初我认为这可能表明一个昂贵的API 2.X兼容性实际上并非如此:2.10是捆绑的Scala版本(提到here)这意味着 25 MB {{3依赖项!所以unecessary swagger版本1.5.X在纯java中重写,并且尺寸要小得多。 scala版本已移至current