Question

当我使用Jaxrs-Analyzer Version 0.9时，它会生成swagger 1.2个json文档。如何配置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>

修改

示例swagger json doc;

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

Answer 1

感谢您使用我的工具！

JAX-RS分析器现在确实生成了Swagger Version 2.0 （而不是1.2）。目前仅支持此版本。

生成的Swagger JSON是否存在不符合Swagger（又称OpenAPI）2.0定义的任何一点？

另见Swagger Definition和Swagger Migration Guide

如何让Jaxrs-Analyzer生成swagger 2定义json文档？

1 个答案: