Как заставить Jaxrs-Analyzer генерировать документацию JSON Swagger 2 определения?

Question

Когда я использую Jaxrs-Analyzer Version 0.9, он генерирует swagger 1.2 JSON Docs. Как я могу настроить jaxrs-analyzer чтобы убедиться, что он генерирует swagger 2 JSON определения?

<plugin>
                <groupId>com.sebastian-daschner</groupId>
                <artifactId>jaxrs-analyzer-maven-plugin</artifactId>
                <version>0.9</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>analyze-jaxrs</goal>
                        </goals>
                        <configuration>
                            <!-- Available backends, defaults to plaintext -->
                            <!-- <backend>plaintext</backend> -->
                            <backend>swagger</backend>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

редактировать

Образец чванства json doc;

{
  "apiVersion" : "1",
  "swaggerVersion" : "1.2",
  "basePath" : "/testwar/rest",
  "resourcePath" : "/TankSystems",
  "apis" : [ {

Answer 1

Спасибо за использование моего инструмента!

JAX-RS Analyzer действительно сейчас генерирует Swagger версии 2.0 (а не 1.2). Только эта версия поддерживается в настоящее время.

Есть ли какие-то моменты, когда сгенерированный Swagger JSON не соответствует определению Swagger (он же OpenAPI) 2.0?

Также см. Определение Swagger и Руководство по миграции Swagger.