Add RAML 1.0 support to jaxrs-to-raml

[jstoiko]

Work-in-progress: https://github.com/mulesoft/raml-for-jax-rs/tree/release/2.0.0

• Extract relevant information from classes/code
• Generate a __raml__ interface for each JAX-RS defined types
• Generate RAML 1.0 from JAX-RS code (CLI)
• Extracting JaxRs resources from a set of compiled classes
• Support for @path classes and methods
• Support for most HTTP verbs (HEAD, POST, GET, DELETE, PUT, OPTIONS)
• Support for media types @consumes and @produces. The default media type is that of JaxRs and is listed as such in the RAML generated. Any method that has a different media type is explicitly declared as such and it is properly generated in the RAML.
• Support for @QueryParam
• Support for @PathParam
• Support for @HeaderParam
• Default values
• Maven plugin that allows to parse compiled classes into RAML
• CLI with same functionalities as the maven plugin
• Support more than primitive types (complex objects) in return values
• Support for @FormParam
• Validations
• Javadoc for descriptions
• XML and Json stub generations -> Examples are generated as RAML data types

[PhilLavoie]

Hi, I can't edit the above list so I'll just insert my own here :):

[list moved to the main description]

Nothing Swagger related is supported as of yet.

[jstoiko]

thanks @PhilLavoie!

[sichvoge]

@jstoiko the mapping for form parameters usually is a simple object type with properties.

[ujjwal-gupta]

What about support for Annotation types as per RAML Issue 174. Being able to mark an endpoint as deprecated is particularly useful.