Mach-II/Mach-II-Framework — Issue #15: WADL Generation for REST endpoints
Author: mpwoodward
Created: 2012-03-01 00:45:47+00:00
State: open
Labels: enhancement

(Moved from http://trac.mach-ii.com/machii/ticket/721)

Provide an automatically generated WADL XML file for the purpose of using an XSL stylesheet to create documentation for the application's rest services.

Changed 17 months ago by jason_york

Status changed from new to assigned
comment:2 Changed 17 months ago by jason_york

(In [2549]) Initial functionality for generating WADL documentation. This still needs work, but this gets the infrastructure in place. refs #721

comment:3 Changed 16 months ago by jason_york

(In [2565]) Allowing default return format to be specified per REST endpoint function. Since we are already using 'format' as a reserved argument, the base REST endpoint looks for a 'default' attribute on that argument and can use that return format if nothing else is specified. This will also be used in the WADL doc gen. refs #721

comment:4 Changed 16 months ago by jason_york

(In [2571]) Ensuring that 'defaultReturnFormat' is always defined refs #721

comment:5 Changed 16 months ago by jason_york

(In [2573]) Don't call 'onSessionEnd' for a module that isn't loaded. Modified CachingListener? to not get strategies for modules that are not loaded. refs #721

comment:6 Changed 15 months ago by peterjfarrell

Milestone changed from Mach-II 1.9.0 Milestone 4 to Mach-II 1.9.0 Milestone 3
Re-targed to 1.9 M3

comment:7 Changed 13 months ago by peterjfarrell

Hey Jason, where are you with this? Is this feature something we should just mark in the Dashboard as "experimental" for the time being? I know that there is a lot of other items we "could" do for WADL. Let me know.

comment:8 Changed 13 months ago by jason_york

Yeah, I'm OK with an experimental note on there. There's more to do to get the output working with IE. I've also been researching JSON schema to be able to capture entities... plus I just need to make the output prettier too.

comment:9 Changed 13 months ago by peterjfarrell

(In [2682]) - Added experimental warning refs #721

comment:10 Changed 13 months ago by peterjfarrell

Milestone changed from Mach-II 1.9.0 Milestone 3 to Mach-II 1.9.5 Milestone 1
I've marked the feature as experimental and retargeted to 1.9.5