JAX-RS Swagger2Feature Spring Demo
=================

The demo shows a basic usage of Swagger 2.0 API documentation with REST based Web Services using 
JAX-RS 2.0 (JSR-339).

Building and running the demo using Maven
---------------------------------------

From the base directory of this sample (i.e., where this README file is
located), the Maven pom.xml file can be used to build and run the demo. 


Using either UNIX or Windows:

  mvn install
  mvn -Pserver  (from one command line window)  
    

After the service is started, the Swagger API documents in JSON and YAML
are available at

  http://localhost:9000/sample/openapi.json
  http://localhost:9000/sample/openapi.yaml

  http://localhost:9000/sample2/openapi.json
  http://localhost:9000/sample2/openapi.yaml

To remove the target dir, run mvn clean".


If you do not have your swagger-ui on your local system, you can download 
a copy from its download site.

At the console, type

  wget -N https://github.com/swagger-api/swagger-ui/archive/master.zip
  unzip master.zip

This will extract the content of the swagger-ui zip file. Using your Browser, open
the index.html file at swagger-ui-master/dist/. Finally, type in the above swagger 
document URL in the input field and click on "Explore" to view the document.



