September 2019
Intermediate to advanced
668 pages
15h 59m
English
Content preview from Hands-On Microservices with Spring Boot and Spring Cloud
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
Start your free trial
Summary
Good documenting of an API is essential for its acceptance, and Swagger is one of the most commonly used specifications when it comes to documenting RESTful services. SpringFox is an opensource project that makes it possible to create Swagger-based API documentation on the fly at runtime by inspecting Spring WebFlux and Swagger annotations. Textual descriptions of an API can be extracted from the annotations in the Java source code and be placed in a property file for ease of editing. SpringFox can be configured to bring in an embedded Swagger viewer to a microservice, which makes it very easy to read about APIs that have been exposed by the microservice and also try them out from the viewer.
Now, what about bringing some life to ...