Add models support to Swagger output

[jmcvetta]

Currently the models field of an API declaration is not generated. Vestigial support is included in the RouteBuilder and swagger.Api types. The models field could be populated inside getDeclarations().

The hard part is generating the json-schema description of the models. Probably best to implement that as a separate library. It can work kinda similarly to json.Marshal().

[emicklei]

Yes, I knew this request was coming soon or later. At the time of writing, this part was not trivial to do. I will have a look at it again.

[jmcvetta]

Still not trivial, I think. Implementing json-schema standard doesn't sound hard, but maybe quite a bit of tedious work. My company may be willing to hire a contractor to build this support - no guarantees tho.

[emicklei]

just begun working on a straightforward implementation using Go reflect package. See how far I can get without the full blown json schema.

[dahankzter]

there is an implementation of json schema pretty far along.

https://github.com/sigu-399/gojsonschema

[emicklei]

I am thinking about providing a way to attach externally stored models (like User.model.js) to the generated API swagger json. Then at least, there is no package dependency with gojsonschema and such a model.js can be created in any way the developer sees fit.