jersey
  1. jersey
  2. JERSEY-235

WADL generation should support producing multiple mime/types

    Details

    • Type: Improvement Improvement
    • Status: Open
    • Priority: Major Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: tools
    • Labels:
      None
    • Environment:

      Operating System: All
      Platform: All

    • Issuezilla Id:
      235
    • Tags:

      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

        Activity

        There are no comments yet on this issue.

          People

          • Assignee:
            Unassigned
            Reporter:
            cquiroz
          • Votes:
            3 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

            • Created:
              Updated: