Enhance Swagger extension to support Restlet API metamodel

[jlouvel]

Currently, the extension only supports JAX-RS API annotations, it would be great to also support the Restlet API resources.

Implementation could reuse the WADL introspection logic already written.

Related to issue #595

workload: 3d

[jlouvel]

@clakech we'll follow up the remaing work for Swagger in this issue.

[thboileau]

What has been done so far:

• added SwaggerServerResource / SwaggerApplication / SwaggerComponent / SwaggerRepresentation to org.restlet.ext.swagger
• leveraged the swagger data model instead of using wadl-like classes (such as ResourceInfo, ApplicationInfo, etc)

To be done:

• adapt the tree structure of the Restlet routing model into the flat structure of the Swagger library.
• complete the Swagger data model, especially the description of the Representation (equivalent to Swagger DocumentationSchema)

[msolujic]

@thboileau @jlouvel can somebody please update documentation for swagger support as it gets extended. Currently, link is broken http://restlet.org/learn/guide/2.2/extensions/swagger
thanks

[jlouvel]

Set prior to medium. Agreed for the doc aspect for 2.2.0