2016-02-22 41 views
7

Swagger-UI'nin okuyabilmesi için Swagger'a özel ek açıklamalar içeren java dosyalarından JSON dosyası nasıl oluşturulur. Java Swagger Annotation Swagger json şemasına nasıl dönüştürülür?

<plugin> 
    <groupId>com.github.kongchen</groupId> 
    <artifactId>swagger-maven-plugin</artifactId> 
    <version>3.1.4</version> 
    <configuration> 
     <apiSources> 
      <apiSource> 
       <springmvc>true/false</springmvc> 
       <locations> 
        <location>com.yourpackage.something</location> 
       </locations> 
       <host>yourhost.com</host> 
       <basePath>/some/path</basePath> 
       <info> 
        <title>Your Project Title</title> 
        <version>${project.version}</version> 
        <description>Some nice stuff</description> 
        <termsOfService>...</termsOfService> 
        <contact> 
         <email>[email protected]</email> 
         <name>Your Name</name> 
         <url>www.where.to.find.you</url> 
        </contact> 
       </info> 
       <swaggerDirectory>path/to/swagger/output</swaggerDirectory> 
       <outputFormats>json</outputFormats> 
      </apiSource> 
     </apiSources> 
    </configuration> 
    <executions> 
     <execution> 
      <phase>compile</phase> 
      <goals> 
       <goal>generate</goal> 
      </goals> 
     </execution> 
    </executions> 
</plugin> 

Sonra mvn compile yapabilir ve swagger.json dosyası oluşturur: Dediğiniz gibi

+0

Lütfen örneklerin nasıl yapıldığını gösteren [swagger örnekleri] (https://github.com/swagger-api/swagger-samples) deposundaki örneklere bakın. Çerçeveniz de dahil olmak üzere bir çok şeye bağlıdır. – fehguy

+0

Çerçeve için Java ve SpringBoot kullanıyorum. –

+0

Yağışlı numunelerdeki repoda, swagger JSON elle oluşturulur, sanırım. Bunu elle yapmak istemiyorum. –

cevap

1

Swagger Maven eklentisi kullanmak "Ben elle yapmak istemiyoruz".