cxf-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Sergey Beryozkin <sberyoz...@gmail.com>
Subject Re: wadl2java and the generation of documentation
Date Wed, 12 Mar 2014 13:55:10 GMT
On 12/03/14 13:42, Sergey Beryozkin wrote:
> Hi
> On 12/03/14 12:47, Graham Leggett wrote:
>> Hi all,
>>
>> I have managed to get the maven cxf-wadl2java-plugin working and
>> generating some interfaces from wadl, and this is working well.
>>
>> One missing piece is documentation - our wadl file contains doc
>> elements, but these doc elements aren't ending up in the code, either
>> as code comments (for the purposes of javadocs) or as Description
>> annotation:
>>
>>      @GET
>>      @Produces("application/json")
>>      Response get(@QueryParam("page") Long page,
>> @QueryParam("pageSize") Long pageSize, @QueryParam("sort") String
>> sort, @QueryParam("fl") String fl,
>>                  @HeaderParam("If-Modified-Since") java.util.Date
>> If_Modified_Since);
>>
>> According to
>> http://cxf.apache.org/docs/jaxrs-services-description.html the docs
>> tell us "Description annotations can be applied to input parameters",
>> but then the docs forget to tell us how.
>>
>> Most specifically, I want the docs tags in the wadl to end up in the
>> generated code. Can anyone confirm how this is done?
>>
> I've opened an enhancement request:
> https://issues.apache.org/jira/browse/CXF-5606
>
> I can also seed a minor issue on the generated signature above,
> 'java.util.Date' should be just 'Date' with 'java.util.Date' going into
> the imports....This is done for complex references but not for 'complex'
> parameter types...needs to be fixed
>
And the parameter name for it needs to start from the lower case, 3 
issues found :-)
> Thanks, Sergey
>
>> Regards,
>> Graham
>> --
>>
>
>


Mime
View raw message