asp.net - Auto-generate ReST web services documentation/WADL -


we creating rest web services using asp.net , openrasta.

is there tool can us:

  • create wadl file

  • or/and create human readable api documentation similar decribed resources/http methods supported each resource, etc ?

for openrasta, it'd possible use uridecorator have help-like uris defined resources (such /myresource$help). can rewrite uri before parsing yo can document easily, parse teh uri, find resource type, , rewrite /help/{resourcetype}

from there register resource system: resourcespace.has.resourcesoftype() .aturi("/help/{resourcetype}") .handledby() .renderedbyxxx()

then can create handler return documentation resource. example use ioperationcreator service know http methodds available , input arguments, use icodecrepository see media types may accepted input, , potentially media type serialization calling codec , generating html friendly view of it.

that's definitly area we're going work on next version.


Comments

Popular posts from this blog

apache - Add omitted ? to URLs -

redirect - bbPress Forum - rewrite to wwww.mysite prohibits login -

php - How can I stop spam on my custom forum/blog? -