There are multiple ways of creating static documentation. However, the basic difference between using swagger-core directly and swagger-maven-plugin is that the former generates the spec at runtime and the latter at build time, and I don’t know which one suits your needs.
It’s possible that swagger-maven-plugin is not updated to the latest version of swagger-core and doesn’t support the new annotations, but that’s a community project that we don’t manage. From: <[email protected]> on behalf of Patrick Verboom <[email protected]> Reply-To: "[email protected]" <[email protected]> Date: Thursday, 19 January 2017 at 7:41 To: Swagger <[email protected]> Subject: Re: swagger jax-rs post json body as string I have upgraded the dependencies to the latest version. I have been trying hard to get it running with swagger-maven-plugin and I didn't get it working for this use case. What would be the best way to create static html ouput from this kind of JAX-RS/swagger annotated project? On Wednesday, January 18, 2017 at 9:03:10 PM UTC+1, Ron wrote: You can do that in various ways, all controlled by the annotations (adding types, manipulating them, adding examples). However, you can’t do most with 1.5.4 (it’s an old version) and swagger-maven-plugin may not support all these new options (whereas swagger-core does). hi, I am currently using swagger 1.5.4 with the swagger-maven-plugin to generate my api docu from my jax-rs services. It is all working fine and the docu is being generated. I have problems with the corner cases where swagger is unable to determine the model from the request/response. In my particular case I use MongoDB. I use the org.bson.Document as a response and in requests I take the body as a string, validate it and convert it into a org.bson.Document. I would like to add json examples and the json schema definition to the swagger documentation. Is this possible and when yes how? Kind regards, Patrick -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
