Wie man Jaxrs-Analyzer herstellt, um jogson docs swagger 2 zu erzeugen?

Question

Wenn ich Jaxrs-Analyzer Version 0.9 verwende, erzeugt es swagger 1.2 json docs. Wie kann ich jaxrs-analyzer konfigurieren, um sicherzustellen, dass es swagger 2 JSON-Definitionen generiert?

<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> 

bearbeiten

Probe Prahlerei json doc;

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

Answer 1

Danke für die Benutzung meines Tools!

Der JAX-RS Analyzer erzeugt in der Tat Swagger Version 2.0 gerade jetzt (nicht 1.2). Nur diese Version wird derzeit unterstützt.

Gibt es Punkte, an denen die erzeugte Swagger JSON zum Swagger (aka OpenAPI) 2.0 Definition entspricht nicht?

Siehe auch Swagger Definition und Swagger Migration Guide