The current ant/maven tasks to generate wadl can be enhanced by means of
extended tags on the java docs.
For example to document the response for a particular resource of a given
media-type you can add the tags
@response.representation.200.doc
@response.representation.200.example
However, the current implementation does not support the case where a resource
has more than one representation type, for example using the tage
@Produces(
{"text/xml", "application/json"}
)
In this case the documentation task will pick only one of them for the WADL file
Ideally you should be able to create javadoc tags that are specific to different
media types
The current ant/maven tasks to generate wadl can be enhanced by means of extended tags on the java docs.
For example to document the response for a particular resource of a given media-type you can add the tags @response.representation.200.doc @response.representation.200.example
However, the current implementation does not support the case where a resource has more than one representation type, for example using the tage
@Produces(
{"text/xml", "application/json"}
)
In this case the documentation task will pick only one of them for the WADL file
Ideally you should be able to create javadoc tags that are specific to different media types
Carlos
Environment
Operating System: All Platform: All