2016-05-18 117 views
0

当我使用Jaxrs-Analyzer Version 0.9时,它会生成swagger 1.2 json文档。我如何配置jaxrs-analyzer以确保它生成swagger 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> 

编辑

样品招摇JSON文档;

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

回答

1

感谢您使用我的工具!

JAX-RS分析仪确实正在生成Swagger版本2.0(不是1.2)。目前只支持这个版本。

是否有任何生成的Swagger JSON不符合Swagger(aka OpenAPI)2.0定义的要点?

另见Swagger DefinitionSwagger Migration Guide

+0

对于我来说,产生招摇1.2 doc..I编辑我的问题与样品JSON。 – Ratha

+0

您是否在使用像swagger-doclet这样的Maven构建中使用其他插件? JAX-RS分析器工具从未包含2.0以上的其他Swagger版本,所以我确信上面的JSON来自其他插件。 –

+0

你是对的,\t com.carma.swagger.doclet.ServiceDoclet引起了问题 – Ratha