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.
You can see this talk at any of the following events:
| Venue | Date | City |
|---|---|---|
| Groovy Users of Minnesota | Feb 9, 2016 | Minneapolis, MN, USA |
| Object Partners | March 18, 2016 | Minneapolis, MN, USA |
| Twin Cities Code Camp | April 16, 2016 | Minneapolis, MN, USA |
| Gr8Conf EU | June 2-3, 2016 | Copenhagen, Denmark |
| Gr8Conf US | July 28, 2016 | Minneapolis, MN, USA |
| JFokus | Feb 8, 2017 | Stockholm, Sweden |
| Greach | March 31, 2017 | Madrid, Spain |
| Code Europe | April 26, 2017 | Kraków, Pl |
Slides for previous presentations are available below:
- 9 Feb 2016 (GUM)
- 18 March 2016 (OPI)
- 16 April 2016 (TCCC)
- June 2016 (Gr8Conf EU)
- July 2016 (Gr8Conf US)
- Feb 2017 (JFokus)
- March 2017 (Greach)
- April 2017 (Code Europe)
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 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! **