users@jersey.java.net

[Jersey] Re: Automatic documentation tool?

From: Robert DiFalco <robert.difalco_at_gmail.com>
Date: Wed, 7 Aug 2013 13:51:00 -0700

How does that help? Is a wadl automatically generated from source that
defines the schema of all the JSON beans?


On Wed, Aug 7, 2013 at 12:58 PM, Matthieu Heimer <matt.heimer_at_osdev.org>wrote:

> You could look at one of the WADL to HTML tools. http://wadl.java.net/
>
> On Wed, Aug 7, 2013 at 1:35 PM, Robert DiFalco <robert.difalco_at_gmail.com>
> wrote:
> > Most everything I have looked at has either required me to double
> annotate
> > stuff, add more data, or shows only minimal information.
> >
> > If seems to me that if I use POJO java beans for all my return values,
> path
> > params, and query params and if the Resources and Beans are well
> javadoc'd
> > that there should be a tool that can auto-generate very good
> documentation
> > showing all the JSON as well as the resource paths and methods. This
> should
> > be able to just run as a maven task scraping the annotations and parsing
> the
> > beans to assemble JSON.
> >
> > Does anyone know if a tool like this exists?
> >
> > Thanks!
> >
> >
>