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
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
Çerçeve için Java ve SpringBoot kullanıyorum. –
Yağışlı numunelerdeki repoda, swagger JSON elle oluşturulur, sanırım. Bunu elle yapmak istemiyorum. –