Hi! On Fri, Dec 23, 2016 at 7:49 PM, Clark Richey <cl...@factgem.com> wrote: > I have very successfully used spring test controllers with swagger. This > article explains the dependencies. > http://www.3pillarglobal.com/insights/restful-api-documentation-using-swagger-and-spring-mvc
Perhaps I should've elaborated in my original question ;-) At the end of the day Swagger is nothing but a static definition for REST APIs (now also known as OpenAPI https://www.openapis.org/). These definition can be either YAML or JSON and they are orthogonal to an API implementation. Next come the tools that allow one to generate server-side scaffolding and client-side libraries. In fact, you can actually use a WebEditor to do that. Try it on an echo example (via File->Open Example in the top left): http://editor.swagger.io/#/ Once you open up that example YAML you can click on Generate Server and Generate Client menus in the same top bar. This is where things get interesting. If you click on General Client and pick Groovy you'll basically get an auto-generated thin wrapper around HTTPBuilder. This is my first question -- is this the best client Groovy code that can be generated from a Swagger description or are there any other generators I may not know about. The Generate Server is more interesting since you don't get Groovy as a choice, but you do get Spring, JAX-RS and Scalatra as choices. This is my 2nd question: for somebody who's interested in quick prototyping of a REST backend based on Swagger definition what would be a recommendation here? Personally, I'd rather have something like Boot and/or Dropwizard, or anything that's Groovy (I'm not a Web guy -- hence asking). Now, treating Java/Groovy source as a source of truth instead of the YAML brings us to my 3d question that you actually answered somewhat: is there any way to generate Groovy REST client based on the Spring annotations that are sprinkled on top of source in your example (I'd assume one way to do it would be to ask for Swagger YAML/JSON to be generated based on those annotations -- but I'll keep my options open ;-)). Thanks, Roman.
