Groovy Spring Boot RESTdocs Example [](https://travis-ci.org/jlstrater/groovy-spring-boot-restdocs-example)

March 16, 2019 · View on GitHub

This project is an example of a groovy spring boot app with Spring RESTdocs added to the spock tests for the talk A Test-Driven Approach to Documenting RESTful APIs with Spring REST Docs as presented by Jennifer Strater.

The published docs from the example are available here.

Upcoming Presentations

You can see this talk at any of the following events:

VenueDateCity
Groovy Users of MinnesotaFeb 9, 2016Minneapolis, MN, USA
Object PartnersMarch 18, 2016Minneapolis, MN, USA
Twin Cities Code CampApril 16, 2016Minneapolis, MN, USA
Gr8Conf EUJune 2-3, 2016Copenhagen, Denmark
Gr8Conf USJuly 28, 2016Minneapolis, MN, USA
JFokusFeb 8, 2017Stockholm, Sweden
GreachMarch 31, 2017Madrid, Spain
Code EuropeApril 26, 2017Kraków, Pl
API Conference DESeptember 20, 2017Berlin, DE
Spring One PlatformDecember 7, 2017San Francisco, CA, USA
Warsaw JUGJune 26, 2018Warsaw, Poland
JavaLandMarch 19 - 21, 2019Phantasialand, Brühl, DE

Slides for previous presentations are available below:

You can build and run this sample using Gradle:

$ gradle build bootRun

Or the Gradle Wrapper:

$ ./gradlew build bootRun

Then access the app via a browser (or curl) on http://localhost:8080/html5/index.html to see the docs.

** It is very important to note that the project must be built before trying to run the project. Otherwise, the docs will not show up! **

Requirements

Java Version 8-10

MongoDB (use default ports locally or run via Docker)