Ich bin neu in Swagger und festgestellt, gibt es zwei Pakete für Swagger Annotation: io.swagger.annotations und com.wordnik.swagger.annotations. Ich frage mich, was ist der Unterschied zwischen ihnen und was ich verwenden soll?Was ist der Unterschied zwischen i.swagger.annotations und com.wordnik.swagger.annotations
Dies sind verschiedene Versionen von Swagger, die zu verschiedenen Versionen anderer unterstützender Software-Stacks gehören, die Sie möglicherweise verwenden.
Ich bin auch auf diese beiden vor einem Monat gestoßen, als ich versuchte, meine Anwendung mit swagger ui zu integrieren. Ich benutzte cxf 2.7.11, Jackson 2.6.0 mit Frühling 3.0.7. Ich habe viel mit com.wordnik gekämpft (ältere Version, in der swagger json unter Verwendung von ApiListingResource usw. auf url api_docs generiert wurde), aber dann dachte ich daran, io.swagger (neuere Version) zu implementieren, nur um den Unterschied zu sehen. Es stellte sich heraus, dass dies die Version war, die ich eigentlich hätte verwenden sollen. Danach ist alles in Ordnung gekommen.
Das com.wordnik Paket ist für die älteren Swagger Spezifikationen, 1.x. Ab swagger Spezifikation 2.0 ist das Paket jetzt io.swagger. Die Anmerkungssignaturen sollten identisch sein, nur das Paket wurde geändert.
Ein Zusatz bei anderen fragt auch:
Wir Prahlerei Version 1.3.13 verwendet, die swagger-core_2.10 genannt wurden. Anfangs dachte ich, dies könnte auf eine Swagger API 2.X Kompatibilität hinweisen, die es eigentlich nicht ist: 2.10 ist die mitgelieferte Scala Version (erwähnt here) Dies bedeutet 25 MB von unecessary abhängigkeiten! So wurde die current swagger Version 1.5.X in reinem Java neu geschrieben und ist viel kleiner in der Größe. Die Scala-Version wurde in eine separate project verschoben.