eclipse-ee4j / eclipse-ee4j/jersey

WADL generation should support producing multiple mime/types

Open
#507 3 comments 0 reactions 0 assignees View on GitHub
Component: tools Priority: Major Type: Improvement wadl
Dominant language
Java
Stars
730
Forks
382
PR merge metrics
No merged PRs in 30d

Description

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

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.