easily generate docs and playground for your RESTful API
You can use the jsondoc-maven-plugin to generate the documentation and save it to a static text file. In this case the plugin will generate a file containing the documentation in json format, ready to be used in the jsondoc-ui
or in your custom documentation viewer. Here is how to declare and use the plugin in your project:
<plugin>
<groupId>org.jsondoc</groupId>
<artifactId>jsondoc-maven-plugin</artifactId>
<version>1.2.23</version>
<configuration>
<version>1.1</version>
<basePath>http://localhost:8080/api</basePath>
<packages>
<package>org.jsondoc.sample.controller</package>
<package>org.jsondoc.sample.pojo</package>
<package>com.sample</package>
</packages>
<outputFile>/tmp/jsondoc.json</outputFile>
<scanner>org.jsondoc.core.scanner.DefaultJSONDocScanner</scanner>
<playgroundEnabled>true</playgroundEnabled> <!-- optional -->
<displayMethodAs>URI</displayMethodAs> <!-- optional -->
</configuration>
</plugin>
And in a terminal:
mvn jsondoc:generate
The scanner
configuration property is useful if you want to use a different implementation of the JSONDocScanner
interface. Currently there is offical support for three implementations:
See Configuration for more information about how to configure the plugin.