users@jersey.java.net

Re: [Jersey] documentation of service

From: tarjei <tarjei_at_nu.no>
Date: Wed, 01 Apr 2009 08:50:37 +0200

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi,
Felipe Gaúcho wrote:
> almost worked: :http://fgaucho.dyndns.org:8080/footprint-service/application.wadl?format=html
>
> On Tue, Mar 31, 2009 at 8:37 PM, Arul Dhesiaseelan <arul_at_fluxcorp.com> wrote:
>> You could try using xml-maven-plugin for transformation, if you are using
>> maven.
>>
>> Or, you could also look at this blog entry[1] which uses a servlet filter to
>> do this.

Way cool :)

Would it be possible to for Jersey to include a basic resource that did
this, so that to get generated documentation for a jersey service all
you had to do was:

@Path("/")
@Service("root")
class MyRootResource {
...
        @Path("/doc")
         Resource getDocs() {
            return new JerseyDocumentationResource();
        }
}

Regards,
Tarjei

>>
>> -Arul
>>
>> [1] http://www.zunisoft.com/?p=127
>>
>> Felipe Gaúcho wrote:
>>> wonderful, how can I include it in my project in a way the
>>> transformation sheet is published in the automatically generated WADL
>>> ? some Glassfish or Jersey trick ?
>>>
>>> On Tue, Mar 31, 2009 at 8:18 PM, Arul Dhesiaseelan <arul_at_fluxcorp.com>
>>> wrote:
>>>
>>>> Here is one from Mark.
>>>>
>>>> http://www.mnot.net/webdesc/
>>>>
>>>> Felipe Gaúcho wrote:
>>>>
>>>>> yep, I noticed..
>>>>>
>>>>> is there a XSLT or something that automatically converts the wadl in a
>>>>> human readable document ?
>>>>>
>>>>>
>>>>>
>>>>> On Tue, Mar 31, 2009 at 7:51 PM, Marc Hadley <Marc.Hadley_at_sun.com>
>>>>> wrote:
>>>>>
>>>>>
>>>>>> Jersey can automatically produce WADL, see here:
>>>>>>
>>>>>> http://wikis.sun.com/display/Jersey/WADL
>>>>>>
>>>>>> Marc.
>>>>>>
>>>>>> On Mar 31, 2009, at 12:26 PM, Felipe Gaúcho wrote:
>>>>>>
>>>>>>
>>>>>>
>>>>>>> is there an automatic way of publishing the rest service documentation
>>>>>>> ?
>>>>>>> like:
>>>>>>>
>>>>>>> the available resources and its parameter types ?
>>>>>>>
>>>>>>> --
>>>>>>>
>>>>>>> Please help to test this application:
>>>>>>> http://fgaucho.dyndns.org:8080/cejug-classifieds-richfaces
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>>> To unsubscribe, e-mail: users-unsubscribe_at_jersey.dev.java.net
>>>>>>> For additional commands, e-mail: users-help_at_jersey.dev.java.net
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: users-unsubscribe_at_jersey.dev.java.net
>>>>>> For additional commands, e-mail: users-help_at_jersey.dev.java.net
>>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>>
>>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: users-unsubscribe_at_jersey.dev.java.net
>>>> For additional commands, e-mail: users-help_at_jersey.dev.java.net
>>>>
>>>>
>>>>
>>>
>>>
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: users-unsubscribe_at_jersey.dev.java.net
>> For additional commands, e-mail: users-help_at_jersey.dev.java.net
>>
>>
>
>
>

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFJ0w69YVRKCnSvzfIRAp4sAKCWVCs6UaZRPbxy+ZDQrJBmEbUhYwCgra0z
k6esUx0Q+psCy8ExoadVmrU=
=gMWf
-----END PGP SIGNATURE-----