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

Question

我对swagger很陌生，并发现有两个用于swagger注释的包: io.swagger.annotations和com.wordnik.swagger.annotations。我想知道它们之间有什么区别，我应该使用什么？

Answer 1

这些是不同版本的swagger，它们与您可能正在使用的其他支持软件栈的不同版本相匹配。

一个月前，当我尝试将我的应用程序与swagger ui集成时，我也遇到了这两个问题。我用的是cxf 2.7.11，jackson 2.6.0和Spring3.0.7。我与com.wordnik (在url api_docs上生成了swagger并使用ApiListingResource等的旧版本)做了很多斗争，但后来想到实现io.swagger (新版本)只是为了了解两者之间的区别。原来那是我一开始就应该使用的版本。从那以后一切都就位了。

Answer 2

com.wordnik包适用于较旧的swagger规范1.x。在swagger规范2.0中，包现在是io.swagger。注释签名应该是相同的，只是包已经改变了。

Answer 3

还有一个补充，以防其他人也感到疑惑：

我们使用了称为swagger-core_2.10的swagger版本1.3.13。最初，我认为这可能表明了一个摆在面前的API2.x兼容性，但实际上并非如此: 2.10是捆绑的Scala版本(提到这里)，这意味着25 MB of 不可缺少的所依赖的！因此，当前 swagger版本1.5.X是用纯java重写的，其大小要小得多。scala版本被移到一个单独项目中。