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

问题描述 投票:12回答:3

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

swagger
3个回答
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(更新版本)只是为了看看差异。原来那是我应该首先使用的版本。之后一切都到位了。


9
投票

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


0
投票

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

我们使用swagger版本1.3.13,称为swagger-core_2.10。最初我认为这可能表明一个昂贵的API 2.X兼容性它实际上不是:2.10是捆绑的Scala版本(提到here)这意味着25 MB的unecessary依赖!所以current swagger 1.5.X版本在纯java中重写,尺寸要小得多。 scala版本被移动到separate project

© www.soinside.com 2019 - 2024. All rights reserved.