3 ms·

I think this is a really good idea. So far I have been using Enunciate to do exactly this (http://www.sonatype.com/people/2010/02/documenting-the-nexus-rest-api

by Feeble 15y ago

I think this is a really good idea. So far I have been using Enunciate to do exactly this (http://www.sonatype.com/people/2010/02/documenting-the-nexus-rest-api-with-enunciate/ http://www.sonatype.com/people/2010/02/documenting-the-nexus...). I have been happy with Enunciate so far but they seem to have lost traction and their API does not work with Java 7 for instance. Swagger looks a bit cooler too ;) That being said, there are some thing that they do that Swagger seems to be missing (or I am just missing it). For instance Enunciate does not require any custom annotations but uses the normal Javadoc instead, which is a very good feature. And how do I run Swagger, can I plug this into my Maven build process and include in the generated war file?

fehguy 15y ago
We tried out enunciate as well. It's good but didn't quite fit our needs... You can run swagger with the built-in support via swagger-core/swagger-jaxrs. Play 1.4/2.0 support is there as well and a number of folks are creating support for other server frameworks. See the samples for integration: https://github.com/wordnik/swagger-core/tree/master/samples https://github.com/wordnik/swagger-core/tree/master/samples But to be honest, you can run the whole system with static files and zero server integration. The downside of using javadocs is that you need to expose sourcecode/docs.